Ottenere i dettagli per un errore nell'app
Usare questo metodo nell'API di analisi di Microsoft Store per ottenere dati dettagliati per un errore specifico dell'app in formato JSON. Questo metodo può recuperare solo i dettagli degli errori che si sono verificati negli ultimi 30 giorni. I dati dettagliati sugli errori sono anche disponibili nella sezione Errori del report sull'integrità nel Centro per i partner.
Per poter usare questo metodo, è innanzitutto necessario usare il metodo di recupero dei dati di segnalazione degli errori per recuperare l'ID dell'errore per cui si desidera recuperare informazioni dettagliate.
Prerequisiti
Per usare questo metodo, è necessario prima eseguire le operazioni seguenti:
- Se non lo si è ancora fatto, completare i prerequisiti per l'API di analisi di Microsoft Store.
- Ottenere un token di accesso di Azure AD da usare nell'intestazione della richiesta per questo metodo. Dopo aver ottenuto un token di accesso, questo sarà disponibile per 60 minuti prima della scadenza. Dopo la scadenza del token, è possibile ottenerne uno nuovo.
- Ottenere l'ID dell'errore per cui si desidera ottenere informazioni dettagliate. Per ottenere questo ID, usare il metodo di recupero dei dati si segnalazione degli errori e usare il valore failureHash nel corpo della risposta di tale metodo.
Richiedi
Sintassi della richiesta
| metodo | URI della richiesta |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v1.0/my/analytics/failuredetails |
Intestazione della richiesta
| Intestazione | Type | Descrizione |
|---|---|---|
| Autorizzazione | stringa | Obbligatorio. Token di accesso di Azure AD nel formato Token di<connessione>. |
Parametri della richiesta
| Parametro | Tipo | Descrizione | Richiesto |
|---|---|---|---|
| applicationId | string | ID dello Store dell'app per cui si desidera recuperare i dati dettagliati sugli errori. L'ID dello Store è disponibile nella pagina di identity app nel Centro per i partner. Un esempio di ID dello Store è 9WZDNCRFJ3Q8. | Sì |
| failureHash | string | ID univoco dell'errore per cui si desidera ottenere informazioni dettagliate. Per ottenere questo valore per l'errore a cui si è interessati, usare il metodo di recupero dei dati di segnalazione degli errori e usare il valore failureHash nel corpo della risposta di tale metodo. | Sì |
| startDate | data | Data di inizio nell'intervallo di date dei dati dettagliati sugli errori da recuperare. Il valore predefinito è 30 giorni prima della data corrente.Nota: questo metodo può recuperare solo i dettagli degli errori che si sono verificati negli ultimi 30 giorni. | No |
| endDate | data | Data di fine nell'intervallo di date dei dati dettagliati sugli errori da recuperare. L'impostazione predefinita è la data corrente. | No |
| migliori | int | Numero di righe di dati da restituire nella richiesta. Il valore massimo e il valore predefinito, se non specificati, sono pari a 10000. Se nella query sono presenti più righe, il corpo della risposta includerà un collegamento che consente di richiedere la pagina successiva dei dati. | No |
| skip | int | Numero di righe da ignorare nella query. Usare questo parametro per scorrere i set di dati di grandi dimensioni. Ad esempio, top=10000 e skip=0 recupera le prime 10.000 righe di dati, top=10000 e skip=10000 recupera le 10.000 righe di dati successive e così via. | No |
| filter | string | Una o più istruzioni che filtrano le righe nella risposta. Ogni istruzione contiene un nome di campo del corpo della risposta e un valore associati agli operatori eq o ne e le istruzioni possono essere combinate usando and o or. I valori stringa devono essere racchiusi tra virgolette singole nel parametro filter. È possibile specificare i campi seguenti del corpo della risposta:
|
No |
| orderby | string | Istruzione che ordina i valori dei dati dei risultati. La sintassi è orderby=field [order],field [order],.... Il parametro field può essere una delle stringhe seguenti:
Il parametro order è facoltativo e può essere asc o desc per specificare l'ordine crescente o decrescente di ogni campo. Il valore predefinito è asc. Di seguito è riportato un esempio di stringa orderby: orderby=date,market |
No |
Esempio di richiesta
Gli esempi seguenti illustrano diverse richieste di recupero di dati dettagliati sugli errori. Sostituire il valore applicationId con l'ID dello Store dell'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>
Response
Corpo della risposta
| Valore | Tipo | Descrizione |
|---|---|---|
| valore | matrice | Matrice di oggetti che contengono dati dettagliati sugli errori. Per ulteriori informazioni sui dati in ogni oggetto, vedere la sezione Valori dei dettagli sugli errori seguente. |
| @nextLink | string | Se vi sono ulteriori pagine di dati, la stringa conterrà un URI che è possibile usare per richiedere la pagina di dati successiva. Ad esempio, questo valore viene restituito se il parametro top della richiesta è impostato su 10 ma vi sono più di 10 righe di errori per la query. |
| TotalCount | integer | Numero totale di righe nei risultati di dati per la query. |
Valori dei dettagli sugli errori
Gli elementi nella matrice Value contengono i valori seguenti.
| Valore | Tipo | Descrizione |
|---|---|---|
| applicationId | string | ID dello Store dell'app per cui si sono recuperati dati dettagliati sugli errori. |
| failureHash | string | Identificatore univoco per l'errore. |
| failureName | string | Nome dell'errore, composto da quattro parti: una o più classi di problema, un codice di controllo eccezione/bug, il nome dell'immagine in cui si è verificato l'errore e il nome della funzione associata. |
| data | string | Prima data dell'intervallo di date per i dati sugli errori. Se la richiesta ha specificato un singolo giorno, questo valore corrisponde alla data. Se la richiesta ha specificato una settimana, un mese o un altro intervallo di date, questo valore corrisponde alla prima data nell'intervallo di date. |
| cabId | string | ID univoco del file CAB associato a questo errore. |
| cabExpirationTime | string | Data e ora in cui il file CAB è scaduto e non può più essere scaricato, in formato ISO 8601. |
| market | string | Codice Paese ISO 3166 del mercato del dispositivo. |
| osBuild | string | Numero di build del sistema operativo in cui si è verificato l'errore. |
| packageVersion | string | Versione del pacchetto dell'app associato a questo errore. |
| deviceModel | string | Stringa che specifica il modello del dispositivo in cui era in esecuzione l'app quando si è verificato l'errore. |
| osVersion | string | Una delle stringhe seguenti che indica la versione del sistema operativo in cui si è verificato l'errore:
|
| osRelease | string | Una delle stringhe seguenti che specifica la release del sistema operativo o l'anello di anteprima (come sottopopolazione all'interno della versione del sistema operativo) in cui è si è verificato l'errore. Per Windows 11: versione 2110 Per Windows 10:
Per Windows Server 1709:
Per Windows Server 2016:
Per Windows 8.1:
Per Windows 7:
Se il rilascio del sistema operativo o l'anello di anteprima è sconosciuto, questo campo ha il valore Unknown. |
| deviceType | string | Una delle stringhe seguenti che specifica il tipo di dispositivo in cui l'app era in esecuzione quando si è verificato l'errore:
|
| cabDownloadable | Booleano | Indica se il file CAB è scaricabile da questo utente. |
Nota
Questo metodo può recuperare solo i dettagli degli errori che si sono verificati negli ultimi 30 giorni.
Esempio di richiesta e risposta
I frammenti di codice seguenti illustrano alcune richieste di esempio e il corpo della risposta JSON per tali richieste.
Richiesta di esempio
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>
Risposta di esempio
{
"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
}