Recuperare i dati sulla segnalazione di errori per l'applicazione desktop
Usa questo metodo nell'API di analisi di Microsoft Store per ottenere dati aggregati sulla segnalazione degli errori per un'applicazione desktop che si è aggiunta al programma per applicazioni desktop di Windows. Questo metodo può recuperare solo gli errori che si sono verificati negli ultimi 30 giorni. Queste informazioni sono anche disponibili nel report sull'integrità per le applicazioni desktop nel Centro per i partner.
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.
Richiedi
Sintassi della richiesta
| metodo | URI della richiesta |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failurehits |
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 prodotto dell'applicazione desktop per cui si desidera recuperare i dati sulla segnalazione degli errori. Per ottenere l'ID prodotto di un'applicazione desktop, aprire qualsiasi report di analisi nel Centro per i partner per l'applicazione desktop (ad esempio il report sull'integrità) e recuperare l'ID prodotto dall'URL. | Sì |
| startDate | data | Data di inizio nell'intervallo di date dei dati di segnalazione errori da recuperare, nel formato mm/dd/yyyy. L'impostazione predefinita è la data corrente.Nota: questo metodo può recuperare solo gli errori che si sono verificati negli ultimi 30 giorni. |
No |
| endDate | data | Data di fine nell'intervallo di date dei dati di segnalazione errori da recuperare, nel formato mm/dd/yyyy. 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 |
| aggregationLevel | string | Specifica l'intervallo di tempo per il quale recuperare i dati aggregati. Può essere una delle stringhe seguenti: giorno, settimana o mese. Se non è specificato, il valore predefinito è day. Se si specifica week o month, i valori failureName e failureHash sono limitati a 1.000 bucket. | 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:
Di seguito è riportato un esempio di stringa orderby: orderby=date,market |
No |
| groupby | string | Istruzione che applica l'aggregazione dei dati solo ai campi specificati. È possibile specificare i campi seguenti:
Le righe di dati restituite conterranno i campi specificati nel parametro groupby e i seguenti:
Il parametro groupby può essere usato con il parametro aggregationLevel. Ad esempio: &groupby=failureName,market&aggregationLevel=week |
No |
Esempio di richiesta
Gli esempi seguenti illustrano diverse richieste di recupero di dati sulla segnalazione degli errori. Sostituire il valore applicationId con l'ID prodotto dell'applicazione desktop.
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failurehits?applicationId=10238467886765136388&startDate=1/1/2018&endDate=2/1/2018&top=10&skip=0 HTTP/1.1
Authorization: Bearer <your access token>
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failurehits?applicationId=10238467886765136388&startDate=8/1/2017&endDate=8/31/2017&skip=0&filter=market eq 'US' and deviceType eq 'PC' HTTP/1.1
Authorization: Bearer <your access token>
Response
Corpo della risposta
| Valore | Tipo | Descrizione |
|---|---|---|
| valore | matrice | Matrice di oggetti che contengono dati aggregati sulla segnalazione degli errori. Per ulteriori informazioni sui dati in ogni oggetto, vedere la sezione Valori 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 10000 ma vi sono più di 10.000 righe di errori per la query. |
| TotalCount | integer | Numero totale di righe nei risultati di dati per la query. |
Valori dell'errore
Gli elementi nella matrice Value contengono i valori seguenti.
| Valore | Tipo | Descrizione |
|---|---|---|
| data | string | Prima data nell'intervallo di date per i dati degli errore, in formato yyyy-mm-dd. Se la richiesta specifica un singolo giorno, questo valore corrisponde alla data. Se la richiesta specifica un intervallo di date più lungo, questo valore corrisponde alla prima data nell'intervallo di date. Per le richieste che specifica un valore aggregationLevel hour, questo valore include anche un valore di ora nel formato hh:mm:ss. |
| applicationId | string | ID prodotto dell'applicazione desktop per cui si sono recuperati i dati sugli errori. |
| productName | string | Nome visualizzato dell'applicazione desktop derivato dai metadati dei relativi eseguibili associati. |
| appName | string | Da definire |
| fileName | string | Nome del file eseguibile per l'applicazione desktop. |
| 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. |
| failureHash | string | Identificatore univoco per l'errore. |
| simbolo | string | Simbolo assegnato a questo errore. |
| osBuild | string | Numero di build in quattro parti del sistema operativo in cui si è verificato l'errore. |
| osVersion | string | Una delle stringhe seguenti che specifica la versione del sistema operativo in cui è installata l'applicazione desktop:
|
| 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. |
| eventType | string | Una delle stringhe seguenti che indica il tipo di evento di errore:
|
| market | string | Codice Paese ISO 3166 del mercato del dispositivo. |
| deviceType | string | Una delle stringhe seguenti che specifica il tipo di dispositivo in cui si è verificato l'errore:
|
| applicationVersion | string | Versione dell'eseguibile dell'applicazione in cui si è verificato l'errore. |
| eventCount | number | Numero di eventi attribuiti a questo errore per il livello di aggregazione specificato. |
Risposta di esempio
L'esempio seguente illustra un esempio di corpo della risposta JSON per questa richiesta.
{
"Value": [
{
"date": "2018-02-01",
"applicationId": "10238467886765136388",
"productName": "Contoso Demo",
"appName": "Contoso Demo",
"fileName": "contosodemo.exe",
"failureName": "SVCHOSTGROUP_localservice_IN_PAGE_ERROR_c0000006_hardware_disk!Unknown",
"failureHash": "11242ef3-ebd8-d525-838d-b5497b225695",
"symbol": "hardware_disk!Unknown",
"osBuild": "10.0.15063.850",
"osVersion": "Windows 10",
"osRelease": "Version 1703",
"eventType": "crash",
"market": "US",
"deviceType": "PC",
"applicationVersion": "2.2.2.0",
"eventCount": 0.0012422360248447205
}
],
"@nextLink": "desktop/failurehits?applicationId=10238467886765136388&aggregationLevel=week&startDate=2018/02/01&endDate2018/02/08&top=1&skip=1",
"TotalCount": 21
}