Obtener las opiniones de la aplicaciónGet app reviews

Use este método en la API de Microsoft Store Analytics para obtener datos de revisión en formato JSON para un intervalo de fechas determinado y otros filtros opcionales.Use this method in the Microsoft Store analytics API to get review data in JSON format for a given date range and other optional filters. Esta información también está disponible en el Informe de revisiones del centro de Partners.This information is also available in the Reviews report in Partner Center.

Después de recuperar las revisiones, puede usar los métodos Get Response info for App Reviews y Submit Response to App Reviews en la API de Microsoft Store Reviews para responder a las revisiones mediante programación.After you retrieve reviews, you can use the get response info for app reviews and submit responses to app reviews methods in the Microsoft Store reviews API to programmatically respond to reviews.

Requisitos previosPrerequisites

Para usar este método, primero debes hacer lo siguiente:To use this method, you need to first do the following:

  • Si aún no lo ha hecho, complete todos los requisitos previos de la API de Microsoft Store Analytics.If you have not done so already, complete all the prerequisites for the Microsoft Store analytics API.
  • Obtén un token de acceso de Azure AD para usarlo en el encabezado de la solicitud de este método.Obtain an Azure AD access token to use in the request header for this method. Una vez que haya obtenido un token de acceso, tiene 60 minutos para usarlo antes de que expire.After you obtain an access token, you have 60 minutes to use it before it expires. Si el token expira, puedes obtener uno nuevo.After the token expires, you can obtain a new one.

SolicitudRequest

Sintaxis de la solicitudRequest syntax

MétodoMethod URI de solicitudRequest URI
GETGET https://manage.devcenter.microsoft.com/v1.0/my/analytics/reviews

Encabezado de solicitudRequest header

EncabezadoHeader TipoType DescripciónDescription
AuthorizationAuthorization stringstring Necesario.Required. El token de acceso de Azure AD del formulario Bearer <token>.The Azure AD access token in the form Bearer <token>.

Parámetros de solicitudRequest parameters

ParámetroParameter TipoType DescripciónDescription RequeridoRequired
applicationIdapplicationId stringstring El identificador de la tienda de la aplicación para la que desea recuperar los datos de revisión.The Store ID of the app for which you want to retrieve review data. Yes
startDatestartDate datedate La fecha de inicio del intervalo de fechas de los datos de revisión que se han de recuperar.The start date in the date range of review data to retrieve. La fecha predeterminada es la actual.The default is the current date. NoNo
endDateendDate datedate Fecha de finalización del intervalo de fechas de los datos de revisión que se han de recuperar.The end date in the date range of review data to retrieve. La fecha predeterminada es la actual.The default is the current date. NoNo
toptop intint Número de filas de datos que se devuelven en la solicitud.The number of rows of data to return in the request. El valor máximo y el valor predeterminado, si no se especifican, es 10 000.The maximum value and the default value if not specified is 10000. Si hay más filas en la consulta, el cuerpo de la respuesta incluye un vínculo que puedes usar para solicitar la siguiente página de datos.If there are more rows in the query, the response body includes a next link that you can use to request the next page of data. NoNo
skipskip intint Número de filas que se omiten en la consulta.The number of rows to skip in the query. Usa este parámetro para consultar grandes conjuntos de datos.Use this parameter to page through large data sets. Por ejemplo, los valores top=10000 y skip=0 recuperan las primeras 10 000 filas de datos, los valores top=10000 y skip=10000 recuperan las siguientes 10 000 filas de datos, y así sucesivamente.For example, top=10000 and skip=0 retrieves the first 10000 rows of data, top=10000 and skip=10000 retrieves the next 10000 rows of data, and so on. NoNo
filterfilter stringstring Una o más instrucciones que filtran las filas de la respuesta.One or more statements that filter the rows in the response. Para obtener más información, consulta la sección filtrar campos a continuación.For more information, see the filter fields section below. NoNo
orderbyorderby stringstring Una instrucción que ordena los valores de datos resultantes.A statement that orders the result data values. La sintaxis es OrderBy = Field [order], Field [order],.... El parámetro de campo puede ser una de las cadenas siguientes:The syntax is orderby=field [order],field [order],.... The field parameter can be one of the following strings:
  • datedate
  • osVersionosVersion
  • datamarketmarket
  • TipoDeDispositivodeviceType
  • isRevisedisRevised
  • packageVersionpackageVersion
  • deviceModeldeviceModel
  • productFamilyproductFamily
  • deviceScreenResolutiondeviceScreenResolution
  • isTouchEnabledisTouchEnabled
  • reviewerNamereviewerName
  • reviewTitlereviewTitle
  • reviewTextreviewText
  • helpfulCounthelpfulCount
  • notHelpfulCountnotHelpfulCount
  • responseDateresponseDate
  • responseTextresponseText
  • deviceRAMdeviceRAM
  • deviceStorageCapacitydeviceStorageCapacity
  • clasificrating

El parámetro order, en cambio, es opcional y puede ser asc o desc para especificar el orden ascendente o descendente de cada campo.The order parameter is optional, and can be asc or desc to specify ascending or descending order for each field. El valor predeterminado es ASC.The default is asc.

Este es un ejemplo de cadena OrderBy : OrderBy = Date, MarketHere is an example orderby string: orderby=date,market

NoNo

Campos de filtroFilter fields

El parámetro filter de la solicitud contiene una o más instrucciones que filtran las filas de la respuesta.The filter parameter of the request contains one or more statements that filter the rows in the response. Cada instrucción contiene un campo y un elemento que se asocian a los operadores eq o ne; asimismo, algunos campos también son compatibles con los operadores contains, gt, lt, ge, y le.Each statement contains a field and value that are associated with the eq or ne operators, and some fields also support the contains, gt, lt, ge, and le operators. Las instrucciones se pueden combinar mediante and u or.Statements can be combined using and or or.

Este es un ejemplo de una cadena filter: filter=contains(reviewText,'great') and contains(reviewText,'ads') and deviceRAM lt 2048 and market eq 'US'Here is an example filter string: filter=contains(reviewText,'great') and contains(reviewText,'ads') and deviceRAM lt 2048 and market eq 'US'

Para obtener una lista de los campos y operadores compatibles de cada campo, consulta la siguiente tabla.For a list of the supported fields and support operators for each field, see the following table. Ten en cuenta que en el parámetro filter los valores de la cadena deben estar entre comillas simples.String values must be surrounded by single quotes in the filter parameter.

CamposFields Operadores admitidosSupported operators DescripciónDescription
marketmarket eq, neeq, ne Cadena que contiene el código de país ISO 3166 del mercado del dispositivo.A string that contains the ISO 3166 country code of the device market.
osVersionosVersion eq, neeq, ne Una de las cadenas siguientes:One of the following strings:
  • Windows Phone 7.5Windows Phone 7.5
  • Windows Phone 8Windows Phone 8
  • Windows Phone 8.1Windows Phone 8.1
  • Windows Phone 10Windows Phone 10
  • Windows 8Windows 8
  • Windows 8.1Windows 8.1
  • Windows 10Windows 10
  • UnknownUnknown
deviceTypedeviceType eq, neeq, ne Una de las cadenas siguientes:One of the following strings:
  • PCPC
  • NúmeroPhone
  • Consola: Xbox OneConsole-Xbox One
  • Consola: serie Xbox XConsole-Xbox Series X
  • IoTIoT
  • HolographicHolographic
  • UnknownUnknown
isRevisedisRevised eq, neeq, ne Especifica true para filtrar las opiniones que hayan sido revisadas; de lo contrario, especifica false.Specify true to filter for reviews that have been revised; otherwise false.
packageVersionpackageVersion eq, neeq, ne Versión del paquete de aplicaciones que se revisó.The version of the app package that was reviewed.
deviceModeldeviceModel eq, neeq, ne Tipo de dispositivo en el cual se revisó la aplicación.The type of device on which the app was reviewed.
productFamilyproductFamily eq, neeq, ne Una de las cadenas siguientes:One of the following strings:
  • PCPC
  • TabletaTablet
  • NúmeroPhone
  • WearableWearable
  • ServerServer
  • CollaborativeCollaborative
  • OtrosOther
deviceRAMdeviceRAM eq, ne, gt, lt, ge, leeq, ne, gt, lt, ge, le La RAM física, en MB.The physical RAM, in MB.
deviceScreenResolutiondeviceScreenResolution eq, neeq, ne La resolución de pantalla del dispositivo en el formato " ancho x alto " .The device screen resolution in the format "width x height".
deviceStorageCapacitydeviceStorageCapacity eq, ne, gt, lt, ge, leeq, ne, gt, lt, ge, le La capacidad del disco de almacenamiento principal, en GB.The capacity of the primary storage disk, in GB.
isTouchEnabledisTouchEnabled eq, neeq, ne Especifica true para filtrar según los dispositivos táctiles; en caso contrario, especifica false.Specify true to filter for touch-enabled devices; otherwise false.
reviewerNamereviewerName eq, neeq, ne El nombre de la persona que ha dado la opinión.The reviewer name.
ratingrating eq, ne, gt, lt, ge, leeq, ne, gt, lt, ge, le La clasificación de la aplicación, en estrellas.The app rating, in stars.
reviewTitlereviewTitle eq, ne, containseq, ne, contains El título de la opinión.The title of the review.
reviewTextreviewText eq, ne, containseq, ne, contains El contenido de texto de la opinión.The text contents of the review.
helpfulCounthelpfulCount eq, neeq, ne El número de veces que la opinión se ha marcado como útil.The number of times the review was marked helpful.
notHelpfulCountnotHelpfulCount eq, neeq, ne El número de veces que la opinión se ha marcado como no útil.The number of times the review was marked not helpful.
responseDateresponseDate eq, neeq, ne La fecha en la que se envió la respuesta.The date that the response was submitted.
responseTextresponseText eq, ne, containseq, ne, contains El contenido de texto de la respuesta.The text contents of the response.
idid eq, neeq, ne IDENTIFICADOR de la revisión (es un GUID).The ID of the review (this is a GUID).

Ejemplo de solicitudRequest example

Los ejemplos siguientes muestran varias solicitudes para obtener datos de opiniones.The following examples demonstrate several requests for getting review data. Sustituye el valor applicationId por el id. de la Tienda de la aplicación.Replace the applicationId value with the Store ID for your app.

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>

ResponseResponse

Cuerpo de la respuestaResponse body

ValueValue TipoType DescripciónDescription
ValueValue arrayarray Matriz de objetos que contienen los datos de revisión.An array of objects that contain review data. Para obtener más información sobre los datos de cada objeto, consulta la sección valores de revisión que encontrarás a continuación.For more information about the data in each object, see the review values section below.
@nextLink stringstring Si hay páginas adicionales de datos, esta cadena contiene un URI que puedes usar para solicitar la siguiente página de datos.If there are additional pages of data, this string contains a URI that you can use to request the next page of data. Por ejemplo, se devuelve este valor si el parámetro top de la solicitud está establecido en 10 000, pero resulta que hay más de 10 000 filas de datos de opiniones de la solicitud.For example, this value is returned if the top parameter of the request is set to 10000 but there are more than 10000 rows of reviews data for the query.
TotalCountTotalCount intint El número total de filas del resultado de datos de la consulta.The total number of rows in the data result for the query.

 

Valores de revisiónReview values

Los elementos de la matriz Value contienen los siguientes valores.Elements in the Value array contain the following values.

ValueValue TipoType DescripciónDescription
datedate stringstring La primera fecha del intervalo de fechas de los datos de opiniones.The first date in the date range for the review data. Si la solicitud especifica un solo día, este valor será esa fecha.If the request specified a single day, this value is that date. Si, por el contrario, la solicitud especifica una semana, un mes u otro intervalo de fechas, este valor será la primera fecha de ese intervalo de fechas.If the request specified a week, month, or other date range, this value is the first date in that date range.
applicationIdapplicationId stringstring El Id. de la Tienda de la aplicación sobre la que estás recuperando los datos de opiniones.The Store ID of the app for which you are retrieving review data.
applicationNameapplicationName stringstring El nombre para mostrar de la aplicación.The display name of the app.
marketmarket stringstring El código de país ISO 3166 del mercado desde el cual se ha enviado la opinión.The ISO 3166 country code of the market where the review was submitted.
osVersionosVersion stringstring La versión del sistema operativo desde el cual se ha enviado la clasificación.The OS version on which the review was submitted. Para obtener una lista de las cadenas admitidas, consulta la sección previa Campos de filtro.For a list of the supported strings, see the filter fields section above.
deviceTypedeviceType stringstring El tipo de dispositivo desde el cual se ha enviado la clasificación.The type of device on which the review was submitted. Para obtener una lista de las cadenas admitidas, consulta la sección previa Campos de filtro.For a list of the supported strings, see the filter fields section above.
isRevisedisRevised BooleanBoolean El valor true indica que la opinión fue revisada; en caso contrario, será false.The value true indicates that the review was revised; otherwise false.
packageVersionpackageVersion stringstring Versión del paquete de aplicaciones que se revisó.The version of the app package that was reviewed.
deviceModeldeviceModel stringstring Tipo de dispositivo en el cual se revisó la aplicación.The type of device on which the app was reviewed.
productFamilyproductFamily stringstring Nombre de la familia de dispositivos.The device family name. Para obtener una lista de las cadenas admitidas, consulta la sección previa Campos de filtro.For a list of the supported strings, see the filter fields section above.
deviceRAMdeviceRAM numbernumber La RAM física, en MB.The physical RAM, in MB.
deviceScreenResolutiondeviceScreenResolution stringstring La resolución de pantalla del dispositivo en el formato "ancho x alto".The device screen resolution in the format "width x height".
deviceStorageCapacitydeviceStorageCapacity numbernumber La capacidad del disco de almacenamiento principal, en GB.The capacity of the primary storage disk, in GB.
isTouchEnabledisTouchEnabled BooleanBoolean El valor true indica que la función táctil está habilitada; de lo contrario, el valor será false.The value true indicates that touch is enabled; otherwise false.
reviewerNamereviewerName stringstring El nombre de la persona que ha dado la opinión.The reviewer name.
ratingrating numbernumber La clasificación de la aplicación, en estrellas.The app rating, in stars.
reviewTitlereviewTitle stringstring El título de la opinión.The title of the review.
reviewTextreviewText stringstring El contenido de texto de la opinión.The text contents of the review.
helpfulCounthelpfulCount numbernumber El número de veces que la opinión se ha marcado como útil.The number of times the review was marked helpful.
notHelpfulCountnotHelpfulCount numbernumber El número de veces que la opinión se ha marcado como no útil.The number of times the review was marked not helpful.
responseDateresponseDate stringstring La fecha en la que se envió una respuesta.The date a response was submitted.
responseTextresponseText stringstring El contenido de texto de la respuesta.The text contents of the response.
idid stringstring IDENTIFICADOR de la revisión (es un GUID).The ID of the review (this is a GUID). Puede usar este identificador en los métodos obtener información de respuesta para las revisiones de la aplicación y enviar respuestas a las revisiones de la aplicación.You can use this ID in the get response info for app reviews and submit responses to app reviews methods.

Ejemplo de respuestaResponse example

En el ejemplo siguiente se muestra el cuerpo de una respuesta JSON de ejemplo realizada para esta solicitud.The following example demonstrates an example JSON response body for this request.

{
  "Value": [
    {
      "date": "2015-07-29",
      "applicationId": "9NBLGGGZ5QDR",
      "applicationName": "Contoso demo",
      "market": "US",
      "osVersion": "10.0.10240.16410",
      "deviceType": "PC",
      "isRevised": true,
      "packageVersion": "",
      "deviceModel": "Microsoft Corporation-Virtual Machine",
      "productFamily": "PC",
      "deviceRAM": -1,
      "deviceScreenResolution": "1024 x 768",
      "deviceStorageCapacity": 51200,
      "isTouchEnabled": false,
      "reviewerName": "ALeksandra",
      "rating": 5,
      "reviewTitle": "Love it",
      "reviewText": "Great app for demos and great dev response.",
      "helpfulCount": 0,
      "notHelpfulCount": 0,
      "responseDate": "2015-08-07T01:50:22.9874488Z",
      "responseText": "1",
      "id": "6be543ff-1c9c-4534-aced-af8b4fbe0316"
    }
  ],
  "@nextLink": null,
  "TotalCount": 1
}