Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Usa questo metodo nell'API di analisi di Microsoft Store per ottenere dati dettagliati per un errore specifico per la tua app in formato JSON. Questo metodo può recuperare solo i dettagli per gli errori che si sono verificati negli ultimi 30 giorni. I dati dettagliati sugli errori sono disponibili anche nel rapporto sulla salute per le applicazioni desktop nel Partner Center.
Prima di poter usare questo metodo, è necessario utilizzare il metodo get error reporting data (Recupera dati di segnalazione errori ) per recuperare l'ID dell'errore per il quale si desidera ottenere informazioni dettagliate.
Prerequisiti
Per usare questo metodo, è prima necessario eseguire le operazioni seguenti:
- Se non è già stato fatto, completare tutti 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, si hanno 60 minuti per usarlo prima della scadenza. Dopo la scadenza del token, è possibile ottenerne uno nuovo.
- Ottenere l'ID dell'errore per il quale si desidera ottenere informazioni dettagliate. Per ottenere questo ID, usare il metodo get error reporting data e usare il valore failureHash nel corpo della risposta di tale metodo.
Richiesta
Sintassi della richiesta
| Metodo | URI della richiesta |
|---|---|
| OTTIENI | https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failuredetails |
Header di richiesta
| Intestazione | TIPO | Descrizione |
|---|---|---|
| Autorizzazione | corda | Obbligatorio. Il token di accesso di Azure AD nel formato Bearer<token>. |
Parametri della richiesta
| Parametro | TIPO | Descrizione | Obbligatorio |
|---|---|---|---|
| ID dell'applicazione | corda | ID prodotto dell'applicazione desktop per cui si desidera recuperare i dettagli dell'errore. Per ottenere l'ID prodotto di un'applicazione desktop, aprire qualsiasi rapporto di analisi per l'applicazione desktop nel Centro per i Partner (ad esempio il rapporto di integrità) e recuperare l'ID prodotto dall'URL. | Sì |
| hashErrore | corda | ID univoco dell'errore per il quale vuoi ottenere informazioni dettagliate. Per ottenere questo valore per l'errore a cui si è interessati, usare il metodo get error reporting data e usare il valore failureHash nel corpo della risposta di tale metodo. | Sì |
| data di inizio | dattero | La data di inizio nell'intervallo temporale dei dati sugli errori dettagliati da recuperare. Il valore predefinito è 30 giorni prima della data corrente. Nota: Questo metodo può recuperare solo i dettagli per gli errori che si sono verificati negli ultimi 30 giorni. | NO |
| Data di fine | dattero | La data di fine nell'intervallo di date per il recupero dei dati dettagliati sugli errori. Il valore predefinito è la data corrente. | NO |
| In alto | Int | Numero di righe di dati da restituire nella richiesta. Il valore massimo e il valore predefinito se non specificato è 10000. Se nella query sono presenti più righe, il corpo della risposta include un collegamento successivo che è possibile usare per richiedere la pagina successiva dei dati. | NO |
| saltare | Int | Numero delle righe da saltare nella query. Usare questo parametro per scorrere set di dati di grandi dimensioni. Ad esempio, top=10 e skip=0 recupera le prime 10 righe di dati, top=10 e skip=10 recupera le 10 righe di dati successive e così via. | NO |
| filtro | corda | Una o più espressioni che filtrano le righe nella risposta. Ogni istruzione contiene un nome di campo dal corpo della risposta e dal valore associati agli operatori eq o ne e le istruzioni possono essere combinate usando eo o. I valori stringa devono essere racchiusi tra virgolette singole nel parametro di filtro . È possibile specificare i campi seguenti dal corpo della risposta:
|
NO |
| ordina per | corda | Istruzione che ordina i valori dei dati risultanti. La sintassi è
Il parametro order è facoltativo e può essere asc o desc per specificare l'ordine crescente o decrescente per ogni campo. Il valore predefinito è asc. Ecco un esempio di stringa orderby : orderby=date,market |
NO |
Esempio di richiesta
Negli esempi seguenti vengono illustrate diverse richieste di recupero di dati dettagliati sugli errori. Sostituire il valore applicationId con l'ID prodotto per l'applicazione desktop.
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failuredetails?applicationId=10238467886765136388&failureHash=00001111-aaaa-2222-bbbb-3333cccc4444&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=00001111-aaaa-2222-bbbb-3333cccc4444&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>
Risposta
Corpo della risposta
| Valore | TIPO | Descrizione |
|---|---|---|
| Valore | elenco | Matrice di oggetti che contengono dati dettagliati sugli errori. Per altre informazioni sui dati in ogni oggetto, vedere la sezione valori dei dettagli dell'errore di seguito. |
| @nextLink | corda | Se sono presenti pagine aggiuntive di dati, questa stringa contiene un URI che è possibile usare per richiedere la pagina successiva dei dati. Questo valore, ad esempio, viene restituito se il parametro superiore della richiesta è impostato su 10, ma sono presenti più di 10 righe di errori per la query. |
| Conteggio totale | numero intero | Numero totale di righe nel risultato dei dati per la query. |
Valori dei dettagli degli errori
Gli elementi nella matrice Value contengono i valori seguenti.
| Valore | TIPO | Descrizione |
|---|---|---|
| ID dell'applicazione | corda | ID prodotto dell'applicazione desktop per cui sono stati recuperati i dettagli dell'errore. |
| hashErrore | corda | Identificatore univoco per l'errore. |
| nomeErrore | corda | Nome dell'errore, costituito da quattro parti: una o più classi di problemi, un codice di controllo di eccezione/bug, il nome dell'immagine in cui si è verificato l'errore e il nome della funzione associata. |
| dattero | corda | La prima data nell'intervallo di date per i dati relativi agli errori. Se la richiesta ha specificato un singolo giorno, questo valore corrisponde a tale 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. |
| cabIdHash | corda | Hash ID univoco del file CAB associato a questo errore. |
| tempo di scadenza cab | corda | Data e ora in cui il file CAB è scaduto e non può più essere scaricato, in formato ISO 8601. |
| mercato | corda | Codice paese ISO 3166 del mercato dei dispositivi. |
| Costruzione del sistema operativo | corda | Numero di build del sistema operativo in cui si è verificato l'errore. |
| versione dell'applicazione | corda | Versione dell'eseguibile dell'applicazione in cui si è verificato l'errore. |
| modello del dispositivo | corda | Stringa che specifica il modello del dispositivo in cui è in esecuzione l'app quando si è verificato l'errore. |
| Versione del sistema operativo | corda | Una delle stringhe seguenti che specifica la versione del sistema operativo in cui è installata l'applicazione desktop:
|
| osRelease | corda | Una delle stringhe seguenti che specifica la versione di rilascio del sistema operativo o l'anello di aggiornamento (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 la versione del sistema operativo o il canale di distribuzione è sconosciuto, questo campo ha il valore Sconosciuto. |
| Tipo di dispositivo | corda | Una delle stringhe seguenti che indica il tipo di dispositivo in cui si è verificato l'errore:
|
| cabinaScaricabile | Booleano | Indica se il file CAB è scaricabile per l'utente. |
| nome del file | corda | Nome del file eseguibile per l'applicazione desktop per cui sono stati recuperati i dettagli dell'errore. |
Esempio di risposta
L'esempio seguente illustra un esempio di corpo della risposta JSON per questa richiesta.
{
"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
}