Obtener las opiniones de la aplicación

Usa este método en la API de análisis de Microsoft Store para obtener datos de revisión en formato JSON para un intervalo de fechas determinado y otros filtros opcionales. Esta información también está disponible en el informe Revisiones del Centro de partners.

Después de recuperar revisiones, puedes usar la información de obtención de respuesta para las revisiones de aplicaciones y enviar respuestas a los métodos de revisión de aplicaciones en la API de opiniones de Microsoft Store para responder mediante programación a las revisiones.

Requisitos previos

Para usar este método, primero debes hacer lo siguiente:

• Si aún no lo has hecho, completa todos los requisitos previos de la API de análisis de Microsoft Store.
• Consigue un token de acceso a Azure AD para utilizarlo en el encabezado de solicitud de este método. Una vez que haya obtenido un token de acceso, tiene 60 minutos para usarlo antes de que expire. Una vez que expire el token, puede obtener uno nuevo.

Solicitar

Sintaxis de la solicitud

Encabezado de solicitud

Parámetros de solicitud

Campos de filtro

El parámetro filter de la solicitud contiene una o varias instrucciones que filtran las filas de la respuesta. Cada instrucción contiene un campo y un valor asociados a los operadores eq o ne , y algunos campos también admiten los operadores contains, gt, lt, ge y le . Las instrucciones se pueden combinar mediante o .

Esta es una cadena de filtro de ejemplo: filter=contains(reviewText,'great') y contains(reviewText,'ads') y deviceRAM lt 2048 y market eq 'US'

Para obtener una lista de los campos admitidos y operadores de soporte técnico para cada campo, consulte la tabla siguiente. Los valores de cadena deben estar entre comillas simples en el parámetro de filtro.

Ejemplo de solicitud

En los ejemplos siguientes se muestran varias solicitudes para obtener datos de revisión. Reemplaza el valor applicationId por el Id. de Store de tu aplicación.

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>

Respuesta

Cuerpo de la respuesta

Revisión de los valores

Los elementos de la matriz Value contienen los valores siguientes.

Ejemplo de solicitud y respuesta

En los fragmentos de código siguientes se muestran algunos ejemplos de solicitud y del cuerpo de la respuesta en formato JSON de esa solicitud.

Solicitud de muestra

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>

Respuesta de ejemplo

{
    "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
}

Temas relacionados

• Informe Críticas
• Acceso a datos analíticos mediante los servicios de Microsoft Store
• Obtener información de respuesta para las revisiones de aplicaciones
• Enviar respuestas a las revisiones de aplicaciones
• Obtener los datos de las adquisiciones de la aplicación
• Obtener los datos de las adquisiciones de complementos
• Obtener los datos de informes de errores
• Obtener las valoraciones de la aplicación