Recuperare le installazioni di applicazioni desktop
Usare questo URI REST per ottenere i dati aggregati sulle installazioni in formato JSON per un'applicazione desktop che si è aggiunta al programma per applicazioni desktop di Windows. Questo URI consente di ottenere i dati sulle installazioni relativi a un determinato intervallo di date e altri filtri facoltativi. Queste informazioni sono anche disponibili nel report sulle installazioni 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/installbasedaily |
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 sulle installazioni. Per ottenere l'ID prodotto di un'applicazione desktop, aprire qualsiasi report di analisi per l'applicazione desktop nel Centro per i partner (ad esempio il report Installazioni) e recuperare l'ID prodotto dall'URL passando il puntatore del mouse sul collegamento per visualizzare i dettagli. | Sì |
| startDate | data | Data di inizio nell'intervallo di date dei dati sulle installazioni da recuperare. Il valore predefinito è 90 giorni prima della data corrente. | No |
| endDate | data | Data di fine nell'intervallo di date dei dati sulle installazioni 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 per ogni installazione. La sintassi è orderby=field [order],field [order],.... Il parametro field può essere uno dei campi seguenti del 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 | string | Istruzione che applica l'aggregazione dei dati solo ai campi specificati. È possibile specificare i campi seguenti del 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 illustra diverse richieste di recupero dei dati sulle installazioni dell'applicazione desktop. Sostituire il valore applicationId con l'ID prodotto dell'applicazione desktop.
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/installbasedaily?applicationId=1234567890&startDate=2018-01-01&endDate=2018-02-01&top=10&skip=0 HTTP/1.1
Authorization: Bearer <your access token>
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/installbasedaily?applicationId=1234567890&startDate=2018-01-01&endDate=2018-02-01&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 sulle installazioni. Per ulteriori informazioni sui dati in ogni oggetto, vedere la tabella 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 dati sulle installazioni per la query. |
| TotalCount | int | Numero totale di righe nei risultati di dati per la query. |
Gli elementi nella matrice Value contengono i valori seguenti.
| Valore | Tipo | Descrizione |
|---|---|---|
| data | string | Data associata al valore di base dell'installazione. |
| applicationId | string | ID prodotto dell'applicazione desktop per cui si sono recuperati i dati sulle installazioni. |
| productName | string | Nome visualizzato dell'applicazione desktop derivato dai metadati dei relativi eseguibili associati. |
| applicationVersion | string | Versione dell'eseguibile dell'applicazione installata. |
| deviceType | string | Una delle stringhe seguenti che specifica il tipo di dispositivo in cui è installata l'applicazione desktop:
|
| market | string | Codice Paese ISO 3166 del mercato in cui è installata l'applicazione desktop. |
| 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 è installata l'applicazione desktop. 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. |
| installBase | number | Numero di dispositivi distinti che avevano installato il prodotto al livello di aggregazione specificato. |
Risposta di esempio
L'esempio seguente illustra un esempio di corpo della risposta JSON per questa richiesta.
{
"Value": [
{
"date": "2018-01-24",
"applicationId": "123456789",
"productName": "Contoso Demo",
"applicationVersion": "1.0.0.0",
"deviceType": "PC",
"market": "All",
"osVersion": "Windows 10",
"osRelease": "Version 1709",
"installBase": 348218.0
}
],
"@nextLink": "desktop/installbasedaily?applicationId=123456789&startDate=2018-01-01&endDate=2018-02-01&top=10000&skip=10000&groupby=applicationVersion,deviceType,osVersion,osRelease",
"TotalCount": 23012
}