Obter dados de relatório de erros para seu aplicativo
Use esse método na API de análise da Microsoft Store para obter dados agregados de relatório de erros para seu aplicativo no formato JSON para um determinado intervalo de datas e outros filtros opcionais. Este método só pode recuperar erros que ocorreram nos últimos 30 dias. Essas informações também estão disponíveis na seção Falhas do relatório Saúde no Partner Center.
Você pode recuperar informações de erro adicionais usando os métodos obter detalhes do erro, obter rastreamento da pilhae baixar arquivo CAB.
Pré-requisitos
Para usar esse método, você precisa primeiro fazer o seguinte:
- Se ainda não tiver feito isso, preencha todos os pré-requisitos para a API de análise da Microsoft Store.
- Obter um token de acesso do Azure AD para usar no cabeçalho da solicitação para este método. Depois de obter um token de acesso, você tem 60 minutos para usá-lo antes que ele expire. Depois que o token expirar, você poderá obter um novo.
Solicitar
Sintaxe da solicitação
| Método | Solicitar URI |
|---|---|
| OBTER | https://manage.devcenter.microsoft.com/v1.0/my/analytics/failurehits |
Cabeçalho da solicitação
| Cabeçalho | Tipo | Descrição |
|---|---|---|
| Autorização | string | Necessário. O token de acesso do Azure AD no formato portador<token>. |
Parâmetros de solicitação
Exemplo de solicitação
Os exemplos a seguir demonstram várias solicitações para obter dados de relatório de erros. Substitua o valor applicationId pela ID da Loja da sua aplicação.
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/failurehits?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/failurehits?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>
Resposta
Corpo de resposta
Valores de erro
Os elementos na matriz Value contêm os seguintes valores.
| Valor | Tipo | Descrição |
|---|---|---|
| data | string | A primeira data no intervalo de datas para os dados de erro, especificada no formato yyyy-mm-dd. Se a solicitação especificar um único dia, esse valor será essa data. Se a solicitação especificar um intervalo de datas maior, esse valor será a primeira data nesse intervalo de datas. Para solicitações que especificam um valor aggregationLevel à hora, este valor também inclui um horário no formato hh:mm:ss. |
| applicationId | string | O ID da loja da app para a qual pretende recuperar dados de erro. |
| nome_do_aplicativo | string | O nome para exibição da aplicação. |
| nomeFalha | cadeia de caracteres | O nome da falha, que é composto por quatro partes: uma ou mais classes de problema, um código de verificação de exceção/bug, o nome da imagem onde a falha ocorreu e o nome da função associada. |
| failureHash | string | O identificador exclusivo do erro. |
| símbolo | string | O símbolo atribuído a este erro. |
| osVersão | string | Uma das seguintes cadeias de caracteres que especifica a versão do sistema operacional na qual o erro ocorreu:
|
| osLançamento | string | Uma das seguintes cadeias de caracteres que especifica a versão do sistema operativo ou o anel de distribuição (como uma subpopulação dentro da versão do sistema operativo) na qual o erro ocorreu. Para Windows 11: versão 2110 Para o Windows 10:
Para o Windows Server 1709:
Para o Windows Server 2016:
Para o Windows 8.1:
Para o Windows 7:
Se a versão do SO ou o anel de distribuição for desconhecido, este campo tem o valor Desconhecido. |
| tipo de evento | string | Uma das seguintes cadeias de caracteres:
|
| mercado | string | O código de país ISO 3166 do mercado de dispositivos. |
| Tipo de dispositivo | string | Uma das seguintes cadeias de caracteres que indica o tipo de dispositivo no qual o erro ocorreu:
|
| Nome do pacote | string | O nome exclusivo do pacote do aplicativo associado a esse erro. |
| packageVersion | string | A versão do pacote do aplicativo que está associada a esse erro. |
| deviceCount | número | O número de dispositivos únicos que correspondem a este erro para o nível de agregação especificado. |
| contagemDeEventos | número | O número de eventos atribuídos a esse erro para o nível de agregação especificado. |
Observação
Este método só pode recuperar erros que ocorreram nos últimos 30 dias.
Exemplo de solicitação e resposta
O trecho de código a seguir demonstra uma solicitação de exemplo e um corpo de resposta JSON para essas solicitações.
Pedido de amostra
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/failurehits?applicationId=9NBLGGGZ5QDR&startDate=07/02/2022&endDate=07/20/2022&top=10&skip=0&filter=market eq 'US'&groupby=failureName,failureHash,symbol,osVersion,eventType,market,deviceType,packageName,packageVersion,osRelease&orderby=date
HTTP/1.1
Authorization: Bearer <your access token>
Exemplo de resposta
{
"Value": [
{
"date": "2022-07-21",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"failureName": "APPLICATION_HANG_BlockedOn_FileIO_Microsoft.Contoso Demo!CEServices.InternalLiveTileUpdaterRuntime_dfffffff_Microsoft.Contoso Demo!unknown_error_in_application",
"failureHash": "c21da75f-ea4d-538b-cfec-73654ef810b9",
"symbol": "Microsoft.Contoso Demo!unknown_error_in_application",
"osVersion": "6.3.9600",
"osRelease": "RTM",
"osArchitecture": null,
"eventType": "hang",
"market": "US",
"deviceType": "PC",
"praid": null,
"packageName": "microsoft.Contoso Demo_2.5.2.34894_x86__8wekyb3d8bbwe",
"packageVersion": "2.5.2.34894",
"ram": null,
"massStorage": null,
"cpu": null,
"cpuManufacturer": null,
"cpuFamilyName": null,
"sandboxId": null,
"deviceCount": 6.0,
"eventCount": 1.05263157894737
},
{
"date": "2022-07-21",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"failureName": "APPLICATION_HANG_BlockedOn_FileIO_Microsoft.Contoso Demo!CEServices.InternalLiveTileUpdaterRuntime_dfffffff_Microsoft.Contoso Demo!unknown_error_in_application",
"failureHash": "c21da75f-ea4d-538b-cfec-73654ef810b9",
"symbol": "Microsoft.Contoso Demo!unknown_error_in_application",
"osVersion": "6.3.9600",
"osRelease": "RTM",
"osArchitecture": null,
"eventType": "hang",
"market": "US",
"deviceType": "Unknown",
"praid": null,
"packageName": "microsoft.Contoso Demo_2.5.2.34894_x86__8wekyb3d8bbwe",
"packageVersion": "2.5.2.34894",
"ram": null,
"massStorage": null,
"cpu": null,
"cpuManufacturer": null,
"cpuFamilyName": null,
"sandboxId": null,
"deviceCount": 7.14285714285714,
"eventCount": 1.05263157894737
},
{
"date": "2022-07-21",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"failureName": "APPLICATION_HANG_Microsoft.Contoso Demo!CEServices.InternalLiveTileUpdaterRuntime_dfffffff_twinapi.appcore.dll!WaitCoalesced",
"failureHash": "233e04bb-7a3d-eb28-c316-1120aa9defc0",
"symbol": "twinapi.appcore.dll!WaitCoalesced",
"osVersion": "6.3.9600",
"osRelease": "RTM",
"osArchitecture": null,
"eventType": "hang",
"market": "US",
"deviceType": "PC",
"praid": null,
"packageName": "microsoft.Contoso Demo_2.5.2.34894_x86__8wekyb3d8bbwe",
"packageVersion": "2.5.2.34894",
"ram": null,
"massStorage": null,
"cpu": null,
"cpuManufacturer": null,
"cpuFamilyName": null,
"sandboxId": null,
"deviceCount": 6.0,
"eventCount": 8.94736842105263
}
],
"@nextLink": "failurehits?applicationId=9NBLGGGZ5QDR&aggregationLevel=day&startDate=2022/07/02&endDate=2022/07/21&top=10&skip=10&groupby=failureName,failureHash,symbol,osVersion,eventType,market,deviceType,packageName,packageVersion,osRelease&filter=market eq 'US'&orderby=date",
"TotalCount": 443
}
Tópicos relacionados
- Relatório de Saúde
- Obter detalhes de um erro no seu aplicativo
- Obter o rastreio de pilha para um erro na tua aplicação
- Baixe o ficheiro CAB para um erro na sua aplicação
- Aceder a dados analíticos usando os serviços da Microsoft Store
- Obtenha mais aquisições de aplicações
- Obtenha aquisições adicionais
- Obter classificações de aplicativos
- Obter avaliações de aplicativos