Obtención de datos de informes de errores para la aplicación de escritorio

2025-06-10

Usa este método en la API de analíticas de Microsoft Store para obtener datos agregados de reporte de errores de una aplicación de escritorio que hayas agregado al programa de Aplicaciones de Escritorio de Windows . Este método solo puede recuperar errores que se produjeron en los últimos 30 días. Esta información también está disponible en el informe Health para aplicaciones de escritorio en Centro de Socios.

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/desktop/failurehits`

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	Identificador de producto de la aplicación de escritorio para la que desea recuperar los datos de informes de errores. Para obtener el identificador de producto de una aplicación de escritorio, abra cualquier informe de análisis de para la aplicación de escritorio en el Centro de Partners (como el informe de estado de ) y recupere el identificador de producto de la dirección URL.	Sí
Fecha de inicio	fecha	Fecha de inicio en el intervalo de fechas de los datos de informes de errores que se van a recuperar, en el formato `mm/dd/yyyy`. El valor predeterminado es la fecha actual. Nota: Este método solo puede recuperar los errores que se produjeron en los últimos 30 días.	No
fecha de finalización	fecha	Fecha de finalización del intervalo de fechas de los datos de informes de errores que se van a recuperar, con el formato `mm/dd/yyyy`. 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. Cada declaración contiene un nombre de campo del cuerpo de respuesta y un valor que están asociados a los operadores eq o ne. Además, las declaraciones se pueden combinar usando y o o. Los valores de cadena deben estar delimitados por comillas simples en el parámetro del filtro . Puede especificar los campos siguientes desde el cuerpo de la respuesta: NombreDelArchivo versión de la aplicación nombreDeFalla fallaHash símbolo versión del sistema operativo osBuild osRelease tipoDeEvento mercado tipoDeDispositivo NombreDelProducto fecha	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. Si especifica semana o mes, los valores de failureName y failureHash están limitados a 1000 particiones.	No
orderby	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: Nombre de archivo versión de la aplicación nombreDeFalla fallaHash símbolo versión del sistema operativo osBuild osRelease tipoDeEvento mercado tipoDeDispositivo NombreDelProducto fecha 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: nombreDeFalla fallaHash símbolo versión del sistema operativo tipoDeEvento mercado tipoDeDispositivo 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 Nombre de la aplicación conteo de eventos El parámetro groupby se puede usar con el parámetro aggregationLevel . Por ejemplo: &groupby=failureName,market&aggregationLevel=week	No

Ejemplo de solicitud

En los ejemplos siguientes se muestran varias solicitudes para obtener datos de informes de errores. Reemplace el valor de applicationId por el identificador de producto de la aplicación de escritorio.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failurehits?applicationId=10238467886765136388&startDate=1/1/2018&endDate=2/1/2018&top=10&skip=0 HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failurehits?applicationId=10238467886765136388&startDate=8/1/2017&endDate=8/31/2017&skip=0&filter=market eq 'US' and deviceType eq 'PC' HTTP/1.1
Authorization: Bearer <your access token>

Respuesta

Cuerpo de respuesta

Importancia	Tipo	Descripción
Importancia	arreglo	Matriz de objetos que contienen datos agregados de informes de errores. Para obtener más información sobre los datos de cada objeto, consulte la sección , valores de error, 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 top de la solicitud se establece en 10000, pero hay más de 10000 filas con errores en la consulta.
Conteo Total	entero	Número total de filas en el resultado de los datos de la consulta.

Valores de error

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 error, en el formato `yyyy-mm-dd`. Si la solicitud especifica un solo día, este valor es esa fecha. Si la solicitud especifica un intervalo de fechas más largo, este valor es la primera fecha de ese intervalo de fechas. Para las solicitudes que especifican un valor de nivel de agregación de hora, este valor también incluye un valor de tiempo en el formato `hh:mm:ss`.
applicationId	cuerda / cadena	Identificador de producto de la aplicación de escritorio de la cual recuperó los datos de error.
Nombre del producto	cuerda / cadena	Nombre visible de la aplicación de escritorio derivado de los metadatos de los ejecutables asociados.
Nombre de la aplicación	cuerda / cadena	Por determinar
Nombre del archivo	cuerda / cadena	Nombre del archivo ejecutable de la aplicación de escritorio.
nombreDeFalla	cuerda / cadena	Nombre del error, que consta de cuatro partes: una o varias clases de problemas, un código de comprobación de errores o excepciones, el nombre de la imagen donde se produjo el error y el nombre de la función asociada.
HashDeError	cuerda / cadena	Identificador único del error.
símbolo	cuerda / cadena	Símbolo asignado a este error.
osBuild	cuerda / cadena	Número de compilación de cuatro partes del sistema operativo en el que se produjo el error.
osVersion	cuerda / cadena	Una de las siguientes cadenas que especifica la versión del sistema operativo en la que está instalada la aplicación de escritorio: Windows 7 Windows 8.1 Windows 10 Windows 11 Windows Server 2016 Windows Server 1709 Desconocido
osRelease	cuerda / cadena	Una de las siguientes cadenas que especifica la versión del sistema operativo o el anillo de despliegue (como subpoblación dentro de la versión del sistema operativo) en la que se produjo el error. Para Windows 11: versión 2110 Para Windows 10: Versión 1507 Versión 1511 Versión 1607 versión 1703 versión 1709 versión 1803 versión preliminar Acceso Rápido para Insiders Insider Lento Para Windows Server 1709: RTM Para Windows Server 2016: Versión 1607 Para Windows 8.1: Actualización 1 Para Windows 7: Paquete de Servicio 1 Si se desconoce la versión del sistema operativo o el anillo de vuelo, este campo tiene el valor Desconocido.
Tipo de evento	cuerda / cadena	Una de las siguientes cadenas que indica el tipo de evento de error: fallo bloquear de memoria jse
mercado	cuerda / cadena	El código de país ISO 3166 del mercado de dispositivos.
tipo de dispositivo	cuerda / cadena	Una de las siguientes cadenas que especifica el tipo de dispositivo en el que se produjo el error: PC Servidor Tableta Desconocido
Versión de la aplicación	cuerda / cadena	Versión del ejecutable de la aplicación en la que se produjo el error.
conteoDeEventos	número	Número de eventos que se atribuyen a este error para el nivel de agregación especificado.

Ejemplo de respuesta

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

{
  "Value": [
    {
      "date": "2018-02-01",
      "applicationId": "10238467886765136388",
      "productName": "Contoso Demo",
      "appName": "Contoso Demo",
      "fileName": "contosodemo.exe",
      "failureName": "SVCHOSTGROUP_localservice_IN_PAGE_ERROR_c0000006_hardware_disk!Unknown",
      "failureHash": "11242ef3-ebd8-d525-838d-b5497b225695",
      "symbol": "hardware_disk!Unknown",
      "osBuild": "10.0.15063.850",
      "osVersion": "Windows 10",
      "osRelease": "Version 1703",
      "eventType": "crash",
      "market": "US",
      "deviceType": "PC",
      "applicationVersion": "2.2.2.0",
      "eventCount": 0.0012422360248447205
    }
  ],
  "@nextLink": "desktop/failurehits?applicationId=10238467886765136388&aggregationLevel=week&startDate=2018/02/01&endDate2018/02/08&top=1&skip=1",
  "TotalCount": 21
}

Compartir a través de