Compartir a través de

Obtención de revisiones de aplicaciones

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 de revisiones en el Centro de Partners.

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

Prerrequisitos

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

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

Solicitud

Sintaxis de la solicitud

Método Solicitud de URI
OBTENER https://manage.devcenter.microsoft.com/v1.0/my/analytics/reviews

Cabecera de solicitud

Cabecera Tipo Descripción
Autorización cuerda / cadena Obligatorio. El token de acceso de Azure AD en la forma Bearer<token>.

Parámetros de solicitud

Parámetro Tipo Descripción Obligatorio
applicationId cuerda / cadena La ID de la tienda de la aplicación para la que quieres recuperar los datos de revisión. Sí
Fecha de inicio fecha Fecha de inicio del intervalo de fechas de los datos de revisión que se van a recuperar. El valor predeterminado es la fecha actual. No
fecha de finalización fecha Fecha de finalización del intervalo de fechas de los datos de revisión que se van a recuperar. El valor predeterminado es la fecha actual. No
Parte superior Int Número de filas de datos que se van a devolver en la solicitud. El valor máximo y el valor predeterminado si no se especifica es 10000. Si hay más filas en la consulta, el cuerpo de la respuesta incluye un vínculo siguiente que puede usar para solicitar la siguiente página de datos. No
saltarse Int Número de filas que se van a omitir en la consulta. Use este parámetro para paginar conjuntos de datos grandes. Por ejemplo, top=10000 y skip=0 recupera las primeras 10000 filas de datos, top=10000 y skip=10000 recupera las siguientes 10000 filas de datos, etc. No
filtro cuerda / cadena Una o varias instrucciones que filtran las filas de la respuesta. Para obtener más información, consulte la siguiente sección de los campos de filtro . No
Ordenar por cuerda / cadena Instrucción que ordena los valores de los datos de resultados. La sintaxis es orderby=field [order],field [order],.... El parámetro field puede ser una de las siguientes cadenas:
  • fecha
  • versión del sistema operativo
  • mercado
  • tipoDeDispositivo
  • ha sido revisado
  • versiónDelPaquete
  • modeloDispositivo
  • productFamily
  • resolución de pantalla del dispositivo
  • estáActivadoTáctilmente
  • reviewerName
  • reviewTitle
  • texto de revisión
  • conteo de útiles
  • conteoNoÚtil
  • responseDate
  • textoDeRespuesta
  • deviceRAM
  • capacidad de almacenamiento del dispositivo
  • Clasificación

El parámetro order es opcional y puede ser asc o desc para especificar el orden ascendente o descendente de cada campo. El valor predeterminado es asc.

Este es un ejemplo de cadena orderby: orderby=date,market

 No

Filtrar campos

El parámetro de filtro de la solicitud contiene una o varias declaraciones 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 el operador contiene, los operadores gt, lt, ge, y los operadores le. Las declaraciones se pueden combinar mediante y, o o.

Este es un ejemplo filtro cadena: 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 delimitados por comillas simples en el parámetro del filtro .

Campos Operadores compatibles Descripción
mercado eq, ne Cadena que contiene el código de país ISO 3166 del mercado de dispositivos.
osVersion eq, ne Una de las siguientes cadenas:
  • Windows Phone 7.5
  • Windows Phone 8
  • Windows Phone 8.1
  • Windows Phone 10
  • Windows 8
  • Windows 8.1
  • Windows 10
  • Windows 11
  • Desconocido
tipo de dispositivo eq, ne Una de las siguientes cadenas:
  • PC
  • Teléfono
  • Console-Xbox Uno
  • Console-Xbox Serie X
  • Internet de las Cosas
  • Holográfico
  • Desconocido
estáRevisado eq, ne Especifique verdadero para filtrar las revisiones que se han revisado; de lo contrario, falso.
versiónDelPaquete eq, ne Versión del paquete de la aplicación que se revisó.
modelo del dispositivo eq, ne Tipo de dispositivo en el que se revisó la aplicación.
familia de productos eq, ne Una de las siguientes cadenas:
  • PC
  • Tableta
  • Teléfono
  • vestible
  • Servidor
  • colaborativo
  • Otros
RAM del dispositivo eq, ne, gt, lt, ge, le Ram físico, en MB.
resolución de pantalla del dispositivo eq, ne La resolución de la pantalla del dispositivo en el formato "ancho x alto".
capacidad de almacenamiento del dispositivo eq, ne, gt, lt, ge, le Capacidad del disco de almacenamiento principal, en GB.
está habilitado el toque eq, ne Especifique true para filtrar por dispositivos táctiles, de lo contrario false.
reviewerName eq, ne Nombre del revisor.
Calificación eq, ne, gt, lt, ge, le La clasificación de la aplicación, en estrellas.
título de la reseña eq, ne, contiene Título de la revisión.
texto de revisión eq, ne, contiene Contenido del texto de la revisión.
helpful Count eq, ne Número de veces que la revisión se marcó como útil.
conteoNoÚtil eq, ne Número de veces que la revisión fue marcada como no útil.
fecha de respuesta eq, ne Fecha en que se envió la respuesta.
textoDeRespuesta eq, ne, contiene Contenido del texto de la respuesta.
identificación eq, ne Identificador de la revisión (se trata de un GUID).

Ejemplo de solicitud

En los ejemplos siguientes se muestran varias solicitudes para obtener datos de revisión. Sustituya el valor de applicationId por el identificador de tienda para su 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 respuesta

Importancia Tipo Descripción
Importancia arreglo Matriz de objetos que contienen datos de revisión. Para obtener más información sobre los datos de cada objeto, consulte la sección revisar los valores a continuación.
@nextLink cuerda / cadena Si hay páginas adicionales de datos, esta cadena contiene un URI que puede usar para solicitar la siguiente página de datos. Por ejemplo, este valor se devuelve si el parámetro superior de la solicitud se establece en 10000, pero hay más de 10000 filas de datos de reseñas para la consulta.
Conteo Total Int Número total de filas en el resultado de los datos de la consulta.

 

Revisión de los valores

Los elementos de la matriz Value contienen los valores siguientes.

Importancia Tipo Descripción
fecha cuerda / cadena La primera fecha del intervalo de fechas de los datos de revisión. Si la solicitud especificó un solo día, este valor es esa fecha. Si la solicitud especificó una semana, mes u otro intervalo de fechas, este valor es la primera fecha de ese intervalo de fechas.
applicationId cuerda / cadena El identificador de la tienda de la aplicación para la que estás recuperando las opiniones.
Nombre de la aplicación cuerda / cadena Nombre visible de la aplicación.
mercado cuerda / cadena Código de país ISO 3166 del mercado donde se envió la revisión.
osVersion cuerda / cadena Versión del sistema operativo en la que se envió la revisión. Para obtener una lista de las cadenas admitidas, consulte la sección campos de filtro anteriores.
tipo de dispositivo cuerda / cadena Tipo de dispositivo en el que se envió la revisión. Para obtener una lista de las cadenas admitidas, consulte la sección campos de filtro anteriores.
estáRevisado Booleano El valor verdadero indica que la evaluación ha sido revisada; de lo contrario, falso.
versiónDelPaquete cuerda / cadena Versión del paquete de la aplicación que se revisó.
modelo del dispositivo cuerda / cadena Tipo de dispositivo en el que se revisó la aplicación.
familia de productos cuerda / cadena Nombre de la familia de dispositivos. Para obtener una lista de las cadenas admitidas, consulte la sección campos de filtro anteriores.
RAM del dispositivo número Ram físico, en MB.
resolución de pantalla del dispositivo cuerda / cadena La resolución de la pantalla del dispositivo en el formato "ancho x alto".
capacidad de almacenamiento del dispositivo número Capacidad del disco de almacenamiento principal, en GB.
está habilitado el toque Booleano El valor true indica que la función táctil está habilitada; de lo contrario, false.
reviewerName cuerda / cadena Nombre del revisor.
Calificación número La clasificación de la aplicación, en estrellas.
título de la reseña cuerda / cadena Título de la revisión.
texto de revisión cuerda / cadena Contenido del texto de la revisión.
helpful Count número Número de veces que la revisión se marcó como útil.
conteoNoÚtil número Número de veces que la revisión fue marcada como no útil.
fecha de respuesta cuerda / cadena Fecha en que se envió una respuesta.
textoDeRespuesta cuerda / cadena Contenido del texto de la respuesta.
identificación cuerda / cadena Identificador de la revisión (se trata de un GUID). Puedes usar este identificador en los métodos de obtener información de respuesta para las revisiones de aplicaciones y de enviar respuestas a las revisiones de aplicaciones.

Ejemplo de solicitud y respuesta

En los fragmentos de código siguientes se muestran algunos ejemplos de solicitud y cuerpo de respuesta JSON para esa solicitud.

Solicitud de ejemplo

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
}