Obter avaliações de app

Use esse método na API de análise da Microsoft Store para obter dados de revisão no formato JSON para um determinado intervalo de datas e outros filtros opcionais. Essas informações também estão disponíveis no relatório de Revisões na Central de Parceiros.

Depois de recuperar as revisões, você pode usar os métodos obter informações de resposta para revisões de aplicativos e enviar respostas a revisões de aplicativos na API de revisões da Microsoft Store para responder programaticamente às revisões.

Pré-requisitos

Para usar este método, primeiro você precisa fazer o seguinte:

• Se você ainda não fez isso, conclua todos os pré-requisitos da API de análise da Microsoft Store.
• Obtenha um token de acesso do Azure AD a ser usado no cabeçalho da solicitação para esse método. Após obter um token de acesso, você tem 60 minutos para usá-lo antes dele expirar. Depois que o token expirar, você poderá obter um novo.

Solicitar

Sintaxe da solicitação

Cabeçalho da solicitação

Parâmetros da solicitação

Filtrar campos

O parâmetro filter da solicitação contém uma ou mais instruções que filtram as linhas na resposta. Cada instrução contém um campo e um valor associados aos operadores eq ou ne , e alguns campos também suportam os operadores contains, gt, lt, ge e le . As instruções podem ser combinadas usando e ou ou.

Aqui está um exemplo de string de filtro : filter=contains(reviewText,'great') e contains(reviewText,'ads') e deviceRAM lt 2048 e market eq 'US'

Para obter uma lista dos campos suportados e operadores de suporte para cada campo, consulte a tabela a seguir. Os valores de sequência devem estar entre aspas simples no parâmetro filter.

Exemplo de solicitação

Os exemplos a seguir demonstram várias solicitações para obter dados de revisão. Substitua o valor applicationId pela ID da Store para seu aplicativo.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/reviews?applicationId=9NBLGGGZ5QDR&startDate=1/1/2015&endDate=2/1/2015&top=10&skip=0 HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/reviews?applicationId=9NBLGGGZ5QDR&startDate=8/1/2015&endDate=8/31/2015&skip=0&filter=contains(reviewText,'great') and contains(reviewText,'ads') and deviceRAM lt 2048 and market eq 'US' HTTP/1.1
Authorization: Bearer <your access token>

Resposta

Corpo da resposta

Revisar valores

Os elementos na matriz Value contêm os valores a seguir.

Exemplo de solicitação e resposta

Os snippets de código a seguir demonstram alguns exemplos de solicitações e o corpo da resposta JSON para estas solicitações.

Solicitação de Exemplo

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/reviews?applicationId=9WZDNCRFJB4P&top=10&skip=0
HTTP/1.1
Authorization: Bearer <your access token>

Resposta de exemplo

{
    "Value": [
        {
            "date": "3/5/2021 12:48:33 PM",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "market": "ES",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "isRevised": false,
            "packageVersion": "2.5.2.34894",
            "reviewerName": "Jose Antonio",
            "rating": 5,
            "reviewTitle": "Contoso Demo",
            "reviewText": "Un juego fantastico",
            "helpfulCount": 3,
            "notHelpfulCount": 0,
            "id": "b5e27de9-2334-4849-d17d-4eae3e1e7aa9"
        },
        {
            "date": "1/6/2021 8:41:42 AM",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "market": "TR",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "isRevised": false,
            "packageVersion": "2.5.2.34894",
            "reviewerName": "fef",
            "rating": 5,
            "helpfulCount": 0,
            "notHelpfulCount": 0,
            "id": "f5d2510a-9796-45ee-01e5-6d5cc4550b09"
        }
    ],
    "TotalCount": 2
}

Tópicos relacionados

• Relatório de avaliações
• Acessar dados analíticos usando os serviços da Microsoft Store
• Obter informações de resposta para avaliações de aplicativos
• Enviar respostas a avaliações de aplicativos
• Obter aquisições de aplicativo
• Obter aquisições de complemento
• Obter dados de relatórios de erros
• Obter classificações de aplicativo