Obtener los detalles asociados a un error en la aplicación de escritorioGet details for an error in your desktop application

Use este método en la API de Microsoft Store Analytics para obtener datos detallados de un error específico de la aplicación en formato JSON.Use this method in the Microsoft Store analytics API to get detailed data for a specific error for your app in JSON format. Este método solo puede recuperar detalles de errores que se hayan producido en los últimos 30 días.This method can only retrieve details for errors that occurred in the last 30 days. Los datos de error detallados también están disponibles en el Informe de mantenimiento de las aplicaciones de escritorio del centro de Partners.Detailed error data is also available in the Health report for desktop applications in Partner Center.

Para poder usar este método, debes usar el método para obtener los datos del informe de errores con el fin de recuperar el identificador del error sobre el que quieres obtener información detallada.Before you can use this method, you must first use the get error reporting data method to retrieve the ID of the error for which you want to get detailed info.

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.
  • Obtén el identificador del error sobre el que quieres obtener información detallada.Get the ID of the error for which you want to get detailed info. Para obtener este identificador, usa el método para obtener los datos del informe de errores y utiliza el valor failureHash en el cuerpo de la respuesta de ese método.To get this ID, use the get error reporting data method and use the failureHash value in the response body of that method.

SolicitudRequest

Sintaxis de la solicitudRequest syntax

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

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 ObligatorioRequired
applicationIdapplicationId stringstring El ID. del producto de la aplicación de escritorio para la que desea recuperar los detalles del error.The product ID of the desktop application for which you want to retrieve error details. Para obtener el identificador de producto de una aplicación de escritorio, abra el Informe de análisis de la aplicación de escritorio en el centro de Partners (como el Informe de mantenimiento) y recupere el identificador de producto de la dirección URL.To get the product ID of a desktop application, open any analytics report for your desktop application in Partner Center (such as the Health report) and retrieve the product ID from the URL. Yes
failureHashfailureHash stringstring El identificador exclusivo del error sobre el que quieres obtener información detallada.The unique ID of the error for which you want to get detailed info. Para obtener este valor respecto al error que te interesa, usa el método para obtener los datos del informe de errores y utiliza el valor failureHash del cuerpo de la respuesta de ese método.To get this value for the error you are interested in, use the get error reporting data method and use the failureHash value in the response body of that method. Yes
startDatestartDate datedate La fecha de inicio del intervalo de fechas de los datos detallados del error que se quieren recuperar.The start date in the date range of detailed error data to retrieve. El valor predeterminado es 30 días antes de la fecha actual.The default is 30 days before the current date.

Nota:     Este método solo puede recuperar los detalles de los errores que se produjeron en los últimos 30 días.Note:  This method can only retrieve details for errors that occurred in the last 30 days.

NoNo
endDateendDate datedate La fecha de finalización del intervalo de fechas de los datos detallados del error que se quieren recuperar.The end date in the date range of detailed error 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=10 y skip=0 recuperan las primeras 10 filas de datos, los valores top=10 y skip=10 recuperan las siguientes 10 filas de datos, y así sucesivamente.For example, top=10 and skip=0 retrieves the first 10 rows of data, top=10 and skip=10 retrieves the next 10 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. 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 con and u or.Each statement contains a field name from the response body and value that are associated with the eq or ne operators, and statements can be combined using and or or. 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. Puede especificar los siguientes campos del cuerpo de la respuesta:You can specify the following fields from the response body:

  • datamarketmarket
  • datedate
  • cabIdHashcabIdHash
  • cabExpirationTimecabExpirationTime
  • deviceTypedeviceType
  • deviceModeldeviceModel
  • osVersionosVersion
  • osReleaseosRelease
  • applicationVersionapplicationVersion
  • osBuildosBuild
  • fileNamefileName
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:
  • datamarketmarket
  • datedate
  • cabIdHashcabIdHash
  • cabExpirationTimecabExpirationTime
  • deviceTypedeviceType
  • deviceModeldeviceModel
  • osVersionosVersion
  • osReleaseosRelease
  • applicationVersionapplicationVersion
  • osBuildosBuild
  • fileNamefileName

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

Ejemplo de solicitudRequest example

Los siguientes ejemplos muestran varias solicitudes para obtener datos detallados del error.The following examples demonstrate several requests for getting detailed error data. Reemplace el valor de ApplicationID por el ID. de producto de la aplicación de escritorio.Replace the applicationId value with the product ID for your desktop application.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failuredetails?applicationId=10238467886765136388&failureHash=012e33e3-dbc9-b12f-c124-9d9810f05d8b&startDate=2016-11-05&endDate=2016-11-06&top=10&skip=0 HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failuredetails?applicationId=10238467886765136388&failureHash=012e33e3-dbc9-b12f-c124-9d9810f05d8b&startDate=2016-11-05&endDate=2016-11-06&top=10&skip=0&filter=market eq 'US' and deviceType eq 'PC' HTTP/1.1
Authorization: Bearer <your access token>

ResponseResponse

Cuerpo de la respuestaResponse body

ValueValue TipoType DescripciónDescription
ValueValue arrayarray Una matriz de objetos que contienen los datos detallados del error.An array of objects that contain detailed error data. Para obtener más información sobre los datos de cada objeto, consulta la sección Valores detallados del error que encontrarás a continuación.For more information about the data in each object, see the error detail 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 errores de la solicitud.For example, this value is returned if the top parameter of the request is set to 10 but there are more than 10 rows of errors for the query.
TotalCountTotalCount integerinteger 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 detallados del errorError detail values

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

ValueValue TipoType DescripciónDescription
applicationIdapplicationId stringstring El ID. del producto de la aplicación de escritorio para la que ha recuperado los detalles del error.The product ID of the desktop application for which you retrieved error details.
failureHashfailureHash stringstring El identificador único del error.The unique identifier for the error.
failureNamefailureName stringstring El nombre del error, que se compone de cuatro partes: una o varias clases problemáticas, un código de comprobación de excepción/error, el nombre de la imagen en la que se produjo el error y el nombre de la función asociada.The name of the failure, which is made up of four parts: one or more problem classes, an exception/bug check code, the name of the image where the failure occurred, and the associated function name.
datedate stringstring La primera fecha del intervalo de fechas de los datos del error.The first date in the date range for the error 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.
cabIdHashcabIdHash stringstring El hash de identificador único del archivo. CAB que está asociado a este error.The unique ID hash of the CAB file that is associated with this error.
cabExpirationTimecabExpirationTime stringstring La fecha y la hora a las que el archivo CAB expira y ya no se puede descargar, en formato ISO 8601.The date and time when the CAB file is expired and can no longer be downloaded, in ISO 8601 format.
marketmarket stringstring El código de país ISO 3166 del mercado del dispositivo.The ISO 3166 country code of the device market.
osBuildosBuild stringstring El número de compilación del sistema operativo en el que se ha producido el error.The build number of the OS on which the error occurred.
applicationVersionapplicationVersion stringstring Versión del archivo ejecutable de la aplicación en el que se produjo el error.The version of the application executable in which the error occurred.
deviceModeldeviceModel stringstring Una cadena que especifica el modelo del dispositivo en el que se estaba ejecutando la aplicación cuando se produjo el error.A string that specifies the model of the device on which the app was running when the error occurred.
osVersionosVersion stringstring Una de las siguientes cadenas que especifica la versión del sistema operativo en la que se instala la aplicación de escritorio:One of the following strings that specifies the OS version on which the desktop application is installed:

  • Windows 7Windows 7
  • Windows 8.1Windows 8.1
  • Windows 10Windows 10
  • Windows Server 2016Windows Server 2016
  • Windows Server 1709Windows Server 1709
  • UnknownUnknown
osReleaseosRelease stringstring Una de las siguientes cadenas que especifica la versión del sistema operativo o el anillo de vuelo (como un rellenado de la versión del sistema operativo) en el que se produjo el error.One of the following strings that specifies the OS release or flighting ring (as a subpopulation within OS version) on which the error occurred.

Para Windows 10:For Windows 10:

  • Versión 1507Version 1507
  • Versión 1511Version 1511
  • Versión 1607Version 1607
  • Versión 1703Version 1703
  • Versión 1709Version 1709
  • Versión 1803Version 1803
  • Versión preliminarRelease Preview
  • Insider rápidoInsider Fast
  • Insider lentoInsider Slow

Para Windows Server 1709:For Windows Server 1709:

  • VERSIÓNRTM

Para Windows Server 2016:For Windows Server 2016:

  • Versión 1607Version 1607

Para Windows 8.1:For Windows 8.1:

  • Actualización 1Update 1

Para Windows 7:For Windows 7:

  • Service Pack 1Service Pack 1

Si se desconoce la versión del sistema operativo o el anillo de vuelo, este campo tiene el valor desconocido.If the OS release or flighting ring is unknown, this field has the value Unknown.

deviceTypedeviceType stringstring Una de las siguientes cadenas que indica el tipo de dispositivo en el que se produjo el error:One of the following strings that indicates the type of device on which the error occurred:

  • PCPC
  • ServerServer
  • UnknownUnknown
cabDownloadablecabDownloadable BooleanBoolean Indica si el usuario puede descargar el archivo CAB.Indicates whether the CAB file is downloadable for this user.
fileNamefileName stringstring Nombre del archivo ejecutable de la aplicación de escritorio para la que se han recuperado los detalles del error.The name of the executable file for the desktop application for which you retrieved error details.

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": [
    {
      "applicationId": "10238467886765136388",
      "failureHash": "012345-5dbc9-b12f-c124-9d9810f05d8b",
      "failureName": "NULL_CLASS_PTR_WRITE_c0000005_contoso.exe!unknown_error_in_process",
      "date": "2018-01-28 23:55:29",
      "cabIdHash": "54ffb83a-e159-41d2-8158-f36f306cc01e",
      "cabExpirationTime": "2018-02-27 23:55:29",
      "market": "US",
      "osBuild": "10.0.10240",
      "applicationVersion": "2.2.2.0",
      "deviceModel": "Contoso All-in-one",
      "osVersion": "Windows 10",
      "osRelease": "Version 1703",
      "deviceType": "PC",
      "cabDownloadable": false,
      "fileName": "contosodemo.exe"
    }
  ],
  "@nextLink": null,
  "TotalCount": 1
}