Obtención de clasificaciones de aplicaciones

Usa este método en la API de análisis de Microsoft Store para obtener datos agregados de clasificaciones 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.

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/ratings`

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 obtener los datos de clasificaciones.	Sí
Fecha de inicio	fecha	Fecha de inicio en el intervalo de fechas de los datos de clasificaciones que se deben 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 clasificaciones 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
nivel de agregación	cuerda / cadena	Especifica el intervalo de tiempo para el que se van a recuperar los datos agregados. Puede ser una de las siguientes cadenas: día, semana o mes. Si no se especifica, el valor predeterminado es day.	No
orderby	cuerda / cadena	Declaración que ordena los valores de datos de resultado para cada clasificación. 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 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
groupby	cuerda / cadena	Instrucción que aplica la agregación de datos solo a los campos especificados. Puede especificar los siguientes campos: fecha Nombre de la aplicación mercado versión del sistema operativo tipoDeDispositivo ha sido revisado Las filas de datos devueltas contendrán los campos especificados en el parámetro groupby , así como los siguientes: fecha Id de la aplicación cincoEstrellas cuatroEstrellas tresEstrellas dosEstrellas unaEstrella El parámetro groupby se puede usar con el parámetro aggregationLevel . Por ejemplo: &groupby=osVersion,market&aggregationLevel=week	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 las instrucciones se pueden combinar mediante yo .

Este es un ejemplo filtro cadena: filter=market eq 'US' y deviceType eq 'phone' y isRevised eq true

Para obtener una lista de los campos admitidos, consulte la tabla siguiente. Los valores de cadena deben estar delimitados por comillas simples en el parámetro del filtro .

Campos	Descripción
mercado	Cadena que contiene el código de país ISO 3166 del mercado donde se clasificó la aplicación.
osVersion	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	Una de las siguientes cadenas: PC Teléfono Console-Xbox One Console-Xbox Serie X Internet de las Cosas Holográfico Desconocido
estáRevisado	Especifique true para filtrar las clasificaciones que se han revisado; de lo contrario, false.

Ejemplo de solicitud

En los ejemplos siguientes se muestran varias solicitudes para obtener datos de clasificaciones. Sustituya el valor de applicationId por el identificador de tienda para su aplicación.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/ratings?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/ratings?applicationId=9NBLGGGZ5QDR&startDate=8/1/2015&endDate=8/31/2015&skip=0&filter=market eq 'US' and deviceType eq 'phone' 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 clasificaciones agregadas. Para obtener más información sobre los datos de cada objeto, consulte la sección valores de clasificación siguiente.
@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 clasificaciones para la consulta.
Conteo Total	Int	Número total de filas en el resultado de los datos de la consulta.

Valores de clasificación

Los elementos de la matriz Value contienen los valores siguientes.

Importancia	Tipo	Descripción
fecha	cuerda / cadena	La fecha inicial del rango de fechas para los datos de valoraciones. 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 ID de la tienda de la aplicación para la que estás obteniendo los datos de valoraciones.
Nombre de la aplicación	cuerda / cadena	Nombre visible de la aplicación.
mercado	cuerda / cadena	El código de país ISO 3166 del mercado donde se envió la clasificación.
osVersion	cuerda / cadena	Versión del sistema operativo en la que se envió la clasificació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 clasificació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 se ha revisado la clasificación; de lo contrario, falso.
oneStar	número	Número de clasificaciones de una estrella.
twoStars	número	Número de clasificaciones de dos estrellas.
threeStars	número	Número de clasificaciones de tres estrellas.
fourStars	número	Número de clasificaciones de cuatro estrellas.
fiveStars	número	Número de valoraciones de cinco estrellas.

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/ratings?applicationId=9NBLGGGZ5QDR
HTTP/1.1
Authorization: Bearer <your access token>

Respuesta de ejemplo


{
    "Value": [
        {
            "date": "2012-09-01",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "oneStar": 1,
            "twoStars": 0,
            "threeStars": 0,
            "fourStars": 1,
            "fiveStars": 3
        },
        {
            "date": "2012-09-02",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "oneStar": 3,
            "twoStars": 0,
            "threeStars": 1,
            "fourStars": 2,
            "fiveStars": 17
        },
        {
            "date": "2012-09-03",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "oneStar": 1,
            "twoStars": 1,
            "threeStars": 1,
            "fourStars": 5,
            "fiveStars": 17
        },
  ],
    "TotalCount": 3
}

Solicitud de ejemplo

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/ratings?applicationId=9NBLGGGZ5QDR&startDate=06/19/2022&endDate=07/20/2022&top=10&skip=0&groupby=date,applicationName,market,osVersion,deviceType,isRevised
HTTP/1.1
Authorization: Bearer <your access token>

Respuesta de ejemplo

{
    "Value": [
        {
            "date": "2022-06-22",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "market": "CL",
            "osVersion": "Windows 11",
            "deviceType": "PC",
            "isRevised": "false",
            "oneStar": 0,
            "twoStars": 0,
            "threeStars": 0,
            "fourStars": 0,
            "fiveStars": 1
        },
        {
            "date": "2022-06-22",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "market": "TR",
            "osVersion": "Windows 11",
            "deviceType": "PC",
            "isRevised": "false",
            "oneStar": 0,
            "twoStars": 0,
            "threeStars": 0,
            "fourStars": 0,
            "fiveStars": 1
        },
        {
            "date": "2022-06-29",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "market": "FR",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "isRevised": "false",
            "oneStar": 0,
            "twoStars": 0,
            "threeStars": 0,
            "fourStars": 1,
            "fiveStars": 0
        },
        {
            "date": "2022-07-01",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "market": "BR",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "isRevised": "false",
            "oneStar": 0,
            "twoStars": 0,
            "threeStars": 0,
            "fourStars": 0,
            "fiveStars": 1
        },
        {
            "date": "2022-07-04",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "market": "ES",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "isRevised": "false",
            "oneStar": 0,
            "twoStars": 0,
            "threeStars": 0,
            "fourStars": 0,
            "fiveStars": 1
        },
        {
            "date": "2022-07-06",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "market": "ES",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "isRevised": "false",
            "oneStar": 0,
            "twoStars": 0,
            "threeStars": 0,
            "fourStars": 0,
            "fiveStars": 1
        },
        {
            "date": "2022-07-07",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "market": "AE",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "isRevised": "true",
            "oneStar": 1,
            "twoStars": 0,
            "threeStars": 0,
            "fourStars": 0,
            "fiveStars": 0
        },
        {
            "date": "2022-07-10",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "market": "BR",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "isRevised": "true",
            "oneStar": 0,
            "twoStars": 0,
            "threeStars": 0,
            "fourStars": 0,
            "fiveStars": 1
        },
        {
            "date": "2022-07-13",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "market": "EG",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "isRevised": "false",
            "oneStar": 0,
            "twoStars": 0,
            "threeStars": 0,
            "fourStars": 0,
            "fiveStars": 1
        },
        {
            "date": "2022-07-14",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "market": "BR",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "isRevised": "true",
            "oneStar": 0,
            "twoStars": 0,
            "threeStars": 0,
            "fourStars": 1,
            "fiveStars": 0
        }
    ],
    "TotalCount": 10
}

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2025-06-10

Compartir a través de

Obtención de clasificaciones de aplicaciones

Prerrequisitos

Solicitud

Sintaxis de la solicitud

Cabecera de solicitud

Parámetros de solicitud

Filtrar campos

Ejemplo de solicitud

Respuesta

Cuerpo de respuesta

Valores de clasificación

Ejemplo de solicitud y respuesta

Solicitud de ejemplo

Respuesta de ejemplo

Solicitud de ejemplo

Respuesta de ejemplo

Temas relacionados

Comentarios

Recursos adicionales