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 URI REST per ottenere informazioni sui dispositivi Windows 10 e Windows 11 in cui l'applicazione desktop blocca l'esecuzione di un aggiornamento di Windows 10 o Windows 11. È possibile usare questo URI solo per le applicazioni desktop aggiunte al programma applicazione desktop di Windows. Queste informazioni sono disponibili anche nel report sui blocchi delle applicazioni per le applicazioni desktop in Partner Center.
Per ottenere informazioni dettagliate sui blocchi di dispositivo per un eseguibile specifico nella tua applicazione desktop, consulta Ottenere i dettagli del blocco di aggiornamento per la tua applicazione desktop.
Prerequisiti
Per usare questo metodo, è prima necessario eseguire le operazioni seguenti:
- Se non l'hai già fatto, completa tutti i prerequisiti e per l'API di analisi del 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.
Richiesta
Sintassi della richiesta
| Metodo | URI della richiesta |
|---|---|
| OTTIENI | https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/blockhits |
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 dati di blocco. Per ottenere l'ID prodotto di un'applicazione desktop, apri un report di analisi qualsiasi per l'applicazione desktop nel Centro Partner (ad esempio, il report Blocchi ) e recupera l'ID prodotto dall'URL. | Sì |
| data di inizio | dattero | Data di inizio dell'intervallo di date per i dati di blocco da recuperare. Il valore predefinito è 90 giorni prima della data corrente. | NO |
| Data di fine | dattero | Data di fine nell'intervallo di date per i blocchi di dati da recuperare. 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 di righe da ignorare nella query. Usare questo parametro per scorrere set di dati di grandi dimensioni. Ad esempio, top=10000 e skip=0 recupera le prime 10000 righe di dati, top=10000 e skip=10000 recupera le 10000 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 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 di filtro . È possibile specificare i campi seguenti dal corpo della risposta:
|
NO |
| ordina per | corda | Una istruzione che ordina i valori dei dati dei risultati per ogni blocco. La sintassi è orderby=field [order],field [order],.... Il parametro del campo può essere uno dei campi seguenti dal corpo della risposta.
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 |
| groupby | corda | Una dichiarazione che applica l'aggregazione dei dati solo ai campi specificati. È possibile specificare i campi seguenti dal corpo della risposta:
Le righe di dati restituite conterranno i campi specificati nel parametro groupby e i seguenti:
|
NO |
Esempio di richiesta
L'esempio seguente dimostra diverse richieste per ottenere i dati di blocco dell'applicazione desktop. Sostituisci il valore applicationId con l'ID prodotto per l'applicazione desktop.
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/blockhits?applicationId=5126873772241846776&startDate=2018-05-01&endDate=2018-06-07&skip=0 HTTP/1.1
Authorization: Bearer <your access token>
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/blockhits?applicationId=5126873772241846776&startDate=2018-05-01&endDate=2018-06-07&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 di blocco aggregati. Per altre informazioni sui dati in ogni oggetto, vedere la tabella seguente. |
| @nextLink | corda | Se sono presenti pagine aggiuntive di dati, questa stringa contiene un URI che è possibile usare per richiedere la pagina successiva dei dati. Ad esempio, questo valore viene restituito se il parametro superiore della richiesta è impostato su 10000, ma per la query sono presenti più di 10000 righe di dati di blocco. |
| Conteggio totale | Int | Numero totale di righe nel risultato dei dati per la query. |
Gli elementi nella matrice Value contengono i valori seguenti.
Esempio di risposta
L'esempio seguente illustra un esempio di corpo della risposta JSON per questa richiesta.
{
"Value": [
{
"applicationId": "10238467886765136388",
"date": "2018-06-03",
"productName": "Contoso Demo",
"fileName": "contosodemo.exe",
"applicationVersion": "2.2.2.0",
"osVersion": "Windows 8.1",
"osRelease": "Update 1",
"market": "ZA",
"deviceType": "All",
"blockType": "Runtime Notification",
"architecture": "X86",
"targetOs": "RS4",
"deviceCount": 120
}
],
"@nextLink": "desktop/blockhits?applicationId=123456789&startDate=2018-01-01&endDate=2018-02-01&top=10000&skip=10000&groupby=applicationVersion,deviceType,osVersion,osRelease",
"TotalCount": 23012
}