Condividi tramite

Recuperare le installazioni di applicazioni desktop

  • Articolo

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:

  • applicationVersion
  • deviceType
  • market
  • osVersion
  • osRelease
 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:

  • productName
  • date
  • applicationVersion
  • deviceType
  • market
  • osVersion
  • osRelease
  • installBase

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:

  • applicationVersion
  • deviceType
  • market
  • osVersion
  • osRelease

Le righe di dati restituite conterranno i campi specificati nel parametro groupby e i seguenti:

  • applicationId
  • date
  • productName
  • installBase

 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:

  • PC
  • Server
  • Tablet
  • Unknown
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:

  • Windows 7
  • Windows 8.1
  • Windows 10
  • Windows 11
  • Windows Server 2016
  • Windows Server 1709
  • Unknown
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:

  • Version 1507
  • Version 1511
  • Version 1607
  • Version 1703
  • Version 1709
  • Release Preview
  • Insider Fast
  • Insider Slow

Per Windows Server 1709:

  • RTM

Per Windows Server 2016:

  • Version 1607

Per Windows 8.1:

  • Aggiornamento 1

Per Windows 7:

  • Service Pack 1

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
}