Compartir a través de

Obtener información detallada de la aplicación de escritorio

  • Artículo

Usa este método en la API de análisis de Microsoft Store para obtener información relacionada con las métricas de estado de una aplicación de escritorio que hayas agregado al programa Aplicación de escritorio de Windows. Estos datos también están disponibles en el informe de estado de las aplicaciones de escritorio en el Centro de partners.

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/desktop/insights

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 Identificador de producto de la aplicación de escritorio para la que desea obtener datos de información. Para obtener el identificador de producto de una aplicación de escritorio, abre cualquier informe de análisis de la aplicación de escritorio en el Centro de partners (como el informe de estado) y recupera el identificador de producto de la dirección URL. Si no especifica este parámetro, el cuerpo de la respuesta contendrá datos de información de todas las aplicaciones registradas en su cuenta. No
startDate date Fecha de inicio en el intervalo de fechas de los datos de información que se van a recuperar. El valor predeterminado es 30 días antes de la fecha actual. No
endDate date Fecha de finalización del intervalo de fechas de los datos de información que se van a recuperar. La fecha actual es el valor predeterminado. No
filter string Una o varias instrucciones que filtran las filas de la respuesta. Cada instrucción contiene un nombre de campo del cuerpo de la respuesta y el valor que están asociados a los operadores eq o ne, y las instrucciones se pueden combinar mediante y u o. Los valores de cadena deben estar entre comillas simples en el parámetro de filtro. Por ejemplo, filter=dataType eq 'acquisition'.

Actualmente, este método solo admite el estado del filtro.

 No

Ejemplo de solicitud

En el ejemplo siguiente se muestra una solicitud para obtener datos de información. Reemplace el valor applicationId por el valor adecuado para la aplicación de escritorio.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/insights?applicationId=10238467886765136388&startDate=6/1/2018&endDate=6/15/2018&filter=dataType eq 'health' 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 información para la aplicación. Para obtener más información sobre los datos de cada objeto, consulte la sección Valores de información a continuación.
TotalCount int Número total de filas que figura en el resultado de datos de la consulta.

Valores de información

Los elementos de la matriz Value contienen los valores siguientes.

Valor Tipo Descripción
applicationId string Identificador de producto de la aplicación de escritorio para la que recuperó los datos de información.
insightDate string Fecha en la que identificamos el cambio en una métrica específica. Esta fecha representa el final de la semana en la que hemos detectado un aumento o una disminución significativos en una métrica en comparación con la semana anterior.
dataType string Cadena que especifica el área de análisis general que informa esta información. Actualmente, este método solo admite el estado.
insightDetail array Uno o más valores de InsightDetail que representan los detalles de la información actual.

Valores de InsightDetail

Valor Tipo Descripción
FactName string Cadena que indica la métrica que describe la información actual o la dimensión actual. Actualmente, este método solo admite el valor HitCount.
SubDimensiones array Uno o varios objetos que describen una sola métrica para la información.
PercentChange string Porcentaje que cambió la métrica en toda la base de clientes.
DimensionName string Nombre de la métrica descrita en la dimensión actual. Algunos ejemplos son EventType, Market, DeviceType y PackageVersion.
DimensionValue string Valor de la métrica que se describe en la dimensión actual. Por ejemplo, si DimensionName es EventType, DimensionValue podría bloquearse o bloquearse.
FactValue string Valor absoluto de la métrica en la fecha en que se detectó la información.
Dirección string Dirección del cambio (positivo o negativo).
Date string Fecha en la que identificamos el cambio relacionado con la información actual o la dimensión actual.

Ejemplo de respuesta

En el ejemplo siguiente se muestra un ejemplo de cuerpo de respuesta en formato JSON para esta solicitud.

{
  "Value": [
    {
      "applicationId": "9NBLGGGZ5QDR",
      "insightDate": "2018-06-03T00:00:00",
      "dataType": "health",
      "insightDetail": [
        {
          "FactName": "HitCount",
          "SubDimensions": [
            {
              "FactName:": "HitCount",
              "PercentChange": "21",
              "DimensionValue:": "DE",
              "FactValue": "109",
              "Direction": "Positive",
              "Date": "6/3/2018 12:00:00 AM",
              "DimensionName": "Market"
            }
          ],
          "DimensionValue": "crash",
          "Date": "6/3/2018 12:00:00 AM",
          "DimensionName": "EventType"
        },
        {
          "FactName": "HitCount",
          "SubDimensions": [
            {
              "FactName:": "HitCount",
              "PercentChange": "71",
              "DimensionValue:": "JP",
              "FactValue": "112",
              "Direction": "Positive",
              "Date": "6/3/2018 12:00:00 AM",
              "DimensionName": "Market"
            }
          ],
          "DimensionValue": "hang",
          "Date": "6/3/2018 12:00:00 AM",
          "DimensionName": "EventType"
        },
      ],
      "insightId": "9CY0F3VBT1AS942AFQaeyO0k2zUKfyOhrOHc0036Iwc="
    }
  ],
  "@nextLink": null,
  "TotalCount": 2
}