Compartir a través de

Obtener las opiniones de la aplicación

  • Artículo

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

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

Encabezado de solicitud

Encabezado Tipo Descripción
Autorización string Necesario. Token de acceso de Azure AD con el formato Token<de portador>.

Parámetros de solicitud

Parámetro Tipo Descripción Obligatorio
applicationId string El Id. de Store de la aplicación de la que quieres recuperar los datos de revisión. Sí
startDate date Fecha de inicio del intervalo de fechas de los datos de revisión que se van a recuperar. La fecha actual es el valor predeterminado. No
endDate date Fecha de finalización del intervalo de fechas de los datos de revisión que se van a recuperar. La fecha actual es el valor predeterminado. No
superior int Número de filas de datos que se van a devolver en la solicitud. Si no se especifica, el valor predeterminado y el valor máximo es 10000. Si hay más filas en la consulta, el cuerpo de la respuesta incluye un vínculo “Siguiente” que puedes usar para solicitar la siguiente página de datos. No
skip int Número de filas que se omiten en la consulta. Usa este parámetro para pasar de página en 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
filter string Una o varias instrucciones que filtran las filas de la respuesta. Para más información, consulte la sección campos de filtro a continuación. No
orderby string Instrucción que ordena los valores de los datos en los resultados. La sintaxis es orderby=field [order],field [order],.... El parámetro field puede estar formado por una de las siguientes cadenas:
  • date
  • osVersion
  • market
  • deviceType
  • isRevised
  • packageVersion
  • deviceModel
  • productFamily
  • deviceScreenResolution
  • isTouchEnabled
  • reviewerName
  • reviewTitle
  • reviewText
  • helpfulCount
  • notHelpfulCount
  • responseDate
  • responseText
  • deviceRAM
  • deviceStorageCapacity
  • rating

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

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.

Fields Operadores admitidos Descripción
market eq, ne Cadena que contiene el código de país ISO 3166 del mercado de dispositivos.
osVersion eq, ne Una de las cadenas siguientes:
  • Windows Phone 7.5
  • Windows Phone 8
  • Windows Phone 8.1
  • Windows Phone 10
  • Windows 8
  • Windows 8.1
  • Windows 10
  • Windows 11
  • Unknown
deviceType eq, ne Una de las cadenas siguientes:
  • PC
  • Teléfono
  • Consola-Xbox One
  • Consola-Xbox Series X
  • IoT
  • Holográfico
  • Unknown
isRevised eq, ne Especifique true para filtrar las revisiones que se han revisado; en caso contrario , false.
packageVersion eq, ne Versión del paquete de la aplicación que se revisó.
deviceModel eq, ne Tipo de dispositivo en el que se revisó la aplicación.
productFamily eq, ne Una de las cadenas siguientes:
  • PC
  • Tablet
  • Teléfono
  • Usable
  • Server
  • Colaborativo
  • Otros
deviceRAM eq, ne, gt, lt, ge, le Ram físico, en MB.
deviceScreenResolution eq, ne Resolución de pantalla del dispositivo con el formato "ancho x alto".
deviceStorageCapacity eq, ne, gt, lt, ge, le Capacidad del disco de almacenamiento principal, en GB.
isTouchEnabled eq, ne Especifique true para filtrar los dispositivos táctiles; en caso contrario , false.
reviewerName eq, ne Nombre del revisor.
rating eq, ne, gt, lt, ge, le La clasificación de la aplicación, en estrellas.
reviewTitle eq, ne, contains Título de la revisión.
reviewText eq, ne, contains Contenido del texto de la revisión.
helpfulCount eq, ne Número de veces que la revisión se marcó como útil.
notHelpfulCount eq, ne Número de veces que la revisión se marcó como no útil.
responseDate eq, ne Fecha en que se envió la respuesta.
responseText eq, ne, contains Contenido del texto de la respuesta.
id 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. 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

Valor Tipo Descripción
Valor array 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 valores de revisión a continuación.
@nextLink string Si hay páginas adicionales de datos, esta cadena contiene un URI que se puede usar para solicitar la siguiente página de datos. Por ejemplo, este valor se devuelve si el parámetro top de la solicitud se establece en 10000, pero hay más de 10000 filas de datos de revisiones para la consulta.
TotalCount int Número total de filas que figura en el resultado de datos de la consulta.

 

Revisión de los valores

Los elementos de la matriz Value contienen los valores siguientes.

Valor Tipo Descripción
date string La primera fecha del intervalo de fechas de los datos de revisión. Si la solicitud especificaba un solo día, este valor es esa fecha. Si la solicitud especificaba una semana, un mes u otro intervalo de fechas, este valor es la primera fecha de ese intervalo de fechas.
applicationId string El identificador de la Tienda de la aplicación para la que estás recuperando los datos de revisión.
applicationName string Nombre para mostrar de la aplicación.
market string Código de país ISO 3166 del mercado donde se envió la revisión.
osVersion string Versión del sistema operativo en la que se envió la revisión. Para obtener una lista de las cadenas admitidas, consulta la sección campos de filtro más arriba.
deviceType string Tipo de dispositivo en el que se envió la revisión. Para obtener una lista de las cadenas admitidas, consulta la sección campos de filtro más arriba.
isRevised Booleano El valor true indica que se ha revisado la revisión; de lo contrario , false.
packageVersion string Versión del paquete de la aplicación que se revisó.
deviceModel string Tipo de dispositivo en el que se revisó la aplicación.
productFamily string Nombre de familia del dispositivo. Para obtener una lista de las cadenas admitidas, consulta la sección campos de filtro más arriba.
deviceRAM number Ram físico, en MB.
deviceScreenResolution string Resolución de pantalla del dispositivo con el formato "ancho x alto".
deviceStorageCapacity number Capacidad del disco de almacenamiento principal, en GB.
isTouchEnabled Booleano El valor true indica que la función táctil está habilitada; en caso contrario , false.
reviewerName string Nombre del revisor.
rating number La clasificación de la aplicación, en estrellas.
reviewTitle string Título de la revisión.
reviewText string Contenido del texto de la revisión.
helpfulCount number Número de veces que la revisión se marcó como útil.
notHelpfulCount number Número de veces que la revisión se marcó como no útil.
responseDate string Fecha en que se envió una respuesta.
responseText string Contenido del texto de la respuesta.
id string Identificador de la revisión (se trata de un GUID). Puedes usar este identificador en la información de obtención de respuesta para las revisiones de aplicaciones y enviar respuestas a los métodos de revisiones de aplicaciones.

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
}