Obter detalhes de um erro em seu app
Use este método na API de análise da Microsoft Store para obter dados detalhados de um erro específico do seu app no formato JSON. Este método só pode recuperar detalhes dos erros que ocorreram nos últimos 30 dias. Os dados detalhados de erro também estão disponíveis na seção Falhas do relatório de integridade no Partner Center.
Antes de usar este método, primeiro você deve usar o método obter dados de relatório de erros para recuperar a ID do erro para o qual você deseja obter informações detalhadas.
Pré-requisitos
Para usar este método, primeiro você precisa do seguinte:
- Se você não tiver feito isso, conclua todos os pré-requisitos para a API de análise da Microsoft Store.
- Obtenha um token de acesso do Azure AD a ser usado no cabeçalho da solicitação para este método. Após obter um token de acesso, você tem 60 minutos para usá-lo antes dele expirar. Depois que o token expirar, você poderá obter um novo.
- Obtenha a ID do erro para o qual você deseja obter informações detalhadas. Para obter essa ID, use o método obter dados de relatório de erros e o valor failureHash no corpo da resposta desse método.
Solicitação
Sintaxe da solicitação
| Método | URI da solicitação |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v1.0/my/analytics/failuredetails |
Cabeçalho da solicitação
| parâmetro | Tipo | Descrição |
|---|---|---|
| Autorização | string | Obrigatórios. O token de acesso Azure AD notoken> de portador< do formulário. |
Parâmetros da solicitação
| Parâmetro | Type | Descrição | Obrigatório |
|---|---|---|---|
| applicationId | string | A ID da Store do app para o qual você deseja recuperar dados de erros detalhados. A ID da Loja está disponível na página Identidade do aplicativo no Partner Center. Uma ID da Store de exemplo é 9WZDNCRFJ3Q8. | Sim |
| failureHash | string | A ID exclusiva do erro para o qual você deseja obter informações detalhadas. Para obter esse valor para o erro no qual você está interessado, use o método obter dados de relatório de erros e o valor failureHash no corpo da resposta desse método. | Sim |
| startDate | date | A data de início no intervalo de datas dos dados de erros detalhados a serem recuperados. O padrão é 30 dias antes da data atual.Nota: Esse método só pode recuperar detalhes de erros ocorridos nos últimos 30 dias. | Não |
| endDate | date | A data de término no intervalo de datas dos dados de erros detalhados a serem recuperados. O padrão é a data atual. | Não |
| top | INT | O número de linhas de dados a serem retornadas na solicitação. O valor máximo e o valor padrão; se não forem especificados, será 10.000. Se houver mais linhas na consulta, o corpo da resposta incluirá um link que você poderá usar para solicitar a próxima página de dados. | Não |
| skip | INT | O número de linhas a serem ignoradas na consulta. Use este parâmetro para percorrer grandes conjuntos de dados. Por exemplo, top=10 e skip=0 recuperam as primeiras 10 linhas de dados, top=10 e skip=10 recuperam as próximas 10 linhas de dados e assim por diante. | Não |
| filter | string | Uma ou mais instruções que filtram as linhas na resposta. Cada instrução contém um nome de campo do corpo de resposta e um valor que estão associados aos operadores eq ou ne, e as instruções podem ser combinadas usando-se and ou or. Os valores de sequência devem estar entre aspas simples no parâmetro filter. Você pode especificar os campos a seguir do corpo da resposta:
|
Não |
| orderby | string | Uma instrução que ordena os valores dos dados de resultado. A sintaxe é orderby=field [order],field [order],.... O parâmetro field pode ser uma das seguintes sequências:
O parâmetro order é opcional e pode ser asc ou desc para especificar a ordem crescente ou decrescente de cada campo. O padrão é asc. Aqui está um exemplo de cadeia de caracteres orderby : orderby=date,market |
Não |
Exemplo de solicitação
Os exemplos a seguir demonstram várias solicitações para a obtenção de dados de erros detalhados. Substitua o valor de applicationId pela ID da Store de seu app.
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/failuredetails?applicationId=9NBLGGGZ5QDR&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/failuredetails?applicationId=9NBLGGGZ5QDR&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 'Windows.Desktop' HTTP/1.1
Authorization: Bearer <your access token>
Resposta
Corpo da resposta
| Valor | Type | Descrição |
|---|---|---|
| Valor | array | Uma matriz de objetos que contêm dados de erros detalhados. Para saber mais sobre os dados em cada objeto, consulte a seção de Valores de detalhes de erros a seguir. |
| @nextLink | string | Se houver páginas adicionais de dados, essa cadeia de caracteres conterá um URI que você poderá usar para solicitar a próxima página de dados. Por exemplo, esse valor será retornado se o parâmetro top da solicitação estiver definido como 10, mas houver mais de 10 linhas de erros para a consulta. |
| TotalCount | inteiro | O número total de linhas no resultado dos dados da consulta. |
Valores de detalhes de erros
Os elementos na matriz Value contêm os valores a seguir.
| Valor | Type | Descrição |
|---|---|---|
| applicationId | string | A ID da Store do app para o qual você recuperou dados de erros detalhados. |
| failureHash | string | O identificador exclusivo do erro. |
| failureName | string | O nome de falha, que é composto de quatro partes: uma ou mais classes de problema, um código de verificação de bug/exceção, o nome da imagem em que ocorreu a falha e o nome da função associada. |
| date | string | A primeira data no intervalo de datas dos dados do erro. Se a solicitação tiver especificado um único dia, o valor será essa data. Se a solicitação especificou uma semana, um mês ou outro intervalo de datas, o valor será a primeira data nesse intervalo de datas. |
| cabId | string | A ID exclusiva do arquivo CAB que está associado a esse erro. |
| cabExpirationTime | string | A data e a hora em que o arquivo CAB expirou e não pôde mais ser baixado, no formato ISO 8601. |
| market | string | O código de país ISO 3166 do mercado do dispositivo. |
| osBuild | string | O número de versão do sistema operacional no qual o erro ocorreu. |
| packageVersion | string | O versão do pacote do aplicativo que está associado a esse erro. |
| deviceModel | string | Uma sequência que especifica o modelo do dispositivo no qual o app era executado quando o erro ocorreu. |
| osVersion | string | Uma das sequências a seguir que indica a versão do sistema operacional no qual ocorreu o erro:
|
| osRelease | string | Uma das sequências a seguir que especifica a versão do sistema operacional ou anel de liberação de versões de pré-lançamento (como uma subpopulação na versão do sistema operacional) no qual o erro ocorreu. Para Windows 11: versão 2110 No Windows 10:
Para o Windows Server 1709:
Para o Windows Server 2016:
No Windows 8.1:
No Windows 7:
Se a versão do sistema operacional ou anel de liberação de versão de pré-lançamento for desconhecida, este campo terá o valor Desconhecido. |
| deviceType | string | Uma das seguintes sequências que especifica o tipo do dispositivo no qual o app era executado quando o erro ocorreu:
|
| cabDownloadable | Boolean | Indica se o arquivo CAB está disponível para download para esse usuário. |
Observação
Este método só pode recuperar detalhes dos erros que ocorreram nos últimos 30 dias.
Exemplo de solicitação e resposta
Os snippets de código a seguir demonstram alguns exemplos de solicitação e corpo de resposta JSON para essas solicitações.
Solicitação de Exemplo
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/failuredetails?applicationId=9NBLGGGZ5QDR&failureHash=012345-5dbc9-b12f-c124-9d9810f05d8b&startDate=2022-06-30&endDate=2022-07-28&top=10&skip=0
HTTP/1.1
Authorization: Bearer <your access token>
Exemplo de Resposta
{
"Value": [
{
"date": "2022-07-12 00:00:00",
"cabExpirationTime": "2022-08-16 01:37:00",
"cabDownloadable": false,
"applicationId": "9NBLGGGZ5QDR",
"failureHash": "012345-5dbc9-b12f-c124-9d9810f05d8b",
"failureName": "MOAPPLICATION_HANG_cfffffff_Microsoft.Contoso!HANG_QUIESCE",
"cabId": "1180087848576586304",
"market": "MX",
"osBuild": "10.0.19043",
"packageVersion": "2.5.2.34894",
"deviceModel": "Dell Inc.-Inspiron 15-3567",
"osVersion": "Windows 10",
"osRelease": "Version 21H1",
"osArchitecture": "x64",
"deviceType": "PC",
"cpuManufacturer": "Intel",
"cpuFamilyName": "Core i5",
"cpuName": "Intel Core i5-7200U CPU @ 2.50GHz",
"praid": "app",
"flightRing": "",
"sandboxId": "retail"
},
{
"date": "2022-07-13 00:00:00",
"cabExpirationTime": "2022-08-17 13:35:53",
"cabDownloadable": true,
"applicationId": "9NBLGGGZ5QDR",
"failureHash": "012345-5dbc9-b12f-c124-9d9810f05d8b",
"failureName": "MOAPPLICATION_HANG_cfffffff_Microsoft.Contoso!HANG_QUIESCE",
"cabId": "2058585545558157474",
"market": "RO",
"osBuild": "10.0.22622",
"packageVersion": "2.5.2.34894",
"deviceModel": "Dell Inc.-Vostro 5502",
"osVersion": "Windows 11",
"osRelease": "External",
"osArchitecture": "x64",
"deviceType": "PC",
"cpuManufacturer": "Intel",
"cpuFamilyName": "Core i5",
"cpuName": "11th Gen Intel Core i5-1135G7 @ 2.40GHz",
"praid": "app",
"flightRing": "external",
"sandboxId": "retail"
},
{
"date": "2022-07-14 00:00:00",
"cabExpirationTime": "2022-08-18 07:27:06",
"cabDownloadable": false,
"applicationId": "9NBLGGGZ5QDR",
"failureHash": "012345-5dbc9-b12f-c124-9d9810f05d8b",
"failureName": "MOAPPLICATION_HANG_cfffffff_Microsoft.Contoso!HANG_QUIESCE",
"cabId": "1940204079766793391",
"market": "IN",
"osBuild": "10.0.19044",
"packageVersion": "2.5.2.34894",
"deviceModel": "Generic Desktop",
"osVersion": "Windows 10",
"osRelease": "Version 21H2",
"osArchitecture": "x64",
"deviceType": "PC",
"cpuManufacturer": "Intel",
"cpuFamilyName": "Pentium",
"cpuName": "Intel Pentium CPU G630 @ 2.70GHz",
"praid": "app",
"flightRing": "",
"sandboxId": "retail"
},
{
"date": "2022-07-17 00:00:00",
"cabExpirationTime": "2022-08-21 10:04:16",
"cabDownloadable": true,
"applicationId": "9NBLGGGZ5QDR",
"failureHash": "012345-5dbc9-b12f-c124-9d9810f05d8b",
"failureName": "MOAPPLICATION_HANG_cfffffff_Microsoft.Contoso!HANG_QUIESCE",
"cabId": "1197051093472061859",
"market": "ES",
"osBuild": "10.0.22621",
"packageVersion": "2.5.2.34894",
"deviceModel": "Microsoft Corporation-Surface Pro 3",
"osVersion": "Windows 11",
"osRelease": "External",
"osArchitecture": "x64",
"deviceType": "PC",
"cpuManufacturer": "Intel",
"cpuFamilyName": "Core i7",
"cpuName": "Intel Core i7-4650U CPU @ 1.70GHz",
"praid": "app",
"flightRing": "external",
"sandboxId": "retail"
},
{
"date": "2022-07-20 00:00:00",
"cabExpirationTime": "2022-08-24 12:40:05",
"cabDownloadable": false,
"applicationId": "9NBLGGGZ5QDR",
"failureHash": "012345-5dbc9-b12f-c124-9d9810f05d8b",
"failureName": "MOAPPLICATION_HANG_cfffffff_Microsoft.Contoso!HANG_QUIESCE",
"cabId": "1332886311327579782",
"market": "RU",
"osBuild": "6.3.9600",
"packageVersion": "2.5.2.34894",
"deviceModel": "ASUSTeK COMPUTER INC.-K75VJ",
"osVersion": "Windows 8.1",
"osRelease": "RTM",
"osArchitecture": "x64",
"deviceType": "PC",
"cpuManufacturer": "Intel",
"cpuFamilyName": "Core i7",
"cpuName": "Intel Core i7-3630QM CPU @ 2.40GHz",
"praid": "app",
"flightRing": "",
"sandboxId": ""
}
],
"TotalCount": 5
}
Tópicos relacionados
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de