Abrufen von Desktopanwendungsinstallationen

  • Artikel

Verwenden Sie diesen REST-URI, um aggregierte Installationsdaten im JSON-Format für eine Desktop-Anwendung abzurufen, die Sie dem Programm Windows Desktop Application hinzugefügt haben. Mit dieser URI können Sie Installationsdaten in einem bestimmten Datumsbereich und andere optionale Filter abrufen. Diese Informationen sind auch im Bericht Installs für Desktop-Anwendungen im Partner Center verfügbar.

Voraussetzungen

Um diese Methode zu verwenden, müssen Sie zuerst Folgendes tun:

  • Falls noch nicht geschehen, erfüllen Sie alle Voraussetzungen für die Microsoft Store-Analyse-API.
  • Rufen Sie ein Azure AD-Zugriffstoken ab, das im Anforderungsheader für diese Methode verwendet wird. Nachdem Sie ein Zugriffstoken erhalten haben, haben Sie 60 Minuten Zeit, es zu verwenden, bevor es abläuft. Nachdem das Token abgelaufen ist, können Sie eine neue abrufen.

Anfordern

Anforderungssyntax

Methode Anforderungs-URI
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/installbasedaily

Anforderungsheader

Header Typ Beschreibung
Autorisierung Zeichenfolge Erforderlich. Das Azure AD-Zugriffstoken im Formular Bearer<-Token>.

Anforderungsparameter

Parameter Typ Beschreibung Erforderlich
applicationId Zeichenfolge Die Produkt-ID der Desktop-Anwendung, für die Sie die Installationsdaten abrufen möchten. Um die Produkt-ID einer Desktop-Anwendung zu ermitteln, öffnen Sie einen beliebigen Analysebericht für Ihre Desktop-Anwendung im Partner Center (z. B. den Bericht Installs) und rufen Sie die Produkt-ID aus der URL ab, indem Sie mit der Maus über den Link fahren, um die Details anzuzeigen. Ja
startDate Datum Das Startdatum im Datumsbereich der abzurufenden Installationsdaten. Der Standardwert ist 90 Tage vor dem aktuellen Datum. Nein
endDate Datum Das Enddatum im Datumsbereich der abzurufenden Installationsdaten. Die Standardeinstellung ist das aktuelle Datum. Nein
Oben int Die Anzahl der Datenzeilen, die in der Anforderung zurückgegeben werden sollen. Der Höchstwert und der Standardwert, falls nicht angegeben, ist 10000. Wenn in der Abfrage weitere Zeilen vorhanden sind, enthält der Antworttext einen nächsten Link, den Sie verwenden können, um die nächste Seite mit Daten anzufordern. Nein
skip int Die Anzahl der Zeilen, die in der Abfrage übersprungen werden sollen. Verwenden Sie diesen Parameter, um große Datasets zu durchlaufen. Beispielsweise ruft top=10000 und skip=0 die ersten 10000 Datenzeilen ab, top=100000 und skip=10000 ruft die nächsten 10000 Datenzeilen usw. ab. Nein
filter Zeichenfolge Eine oder mehrere Anweisungen, die die Zeilen in der Antwort filtern. Jede Anweisung enthält einen Feldnamen aus dem Antwortkörper und einen Wert, die mit den Operatoren eq oder ne verbunden sind, und Anweisungen können mit and oder or kombiniert werden. Zeichenfolgenwerte müssen von einfachen Anführungszeichen im Filter-Parameter umgeben sein. Sie können die folgenden Felder aus dem Antworttext angeben:

  • applicationVersion
  • DeviceType
  • market
  • osVersion
  • osRelease
 Nein
orderby Zeichenfolge Eine Anweisung, die die Ergebnisdatenwerte für jede Installation anordnet. Die Syntax ist orderby=Feld [order],Feld [order],.... Der Feld-Parameter kann eines der folgenden Felder aus dem Antworttext sein:

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

Der Order-Parameter ist optional und kann asc oder desc sein, um die aufsteigende oder absteigende Reihenfolge für jedes Feld anzugeben. Die Standardeinstellung ist asc.

Hier ist ein Beispiel für eine orderby-Zeichenfolge: orderby=date,market

 Nein
groupby Zeichenfolge Eine Anweisung, die Datenaggregation nur auf die angegebenen Felder anwendet. Sie können die folgenden Felder aus dem Antworttext angeben:

  • applicationVersion
  • DeviceType
  • market
  • osVersion
  • osRelease

Die zurückgegebenen Datenzeilen enthalten die im groupby-Parameter angegebenen Felder sowie Folgendes:

  • applicationId
  • date
  • productName
  • installBase

 Nein

Anforderungsbeispiel

Das folgende Beispiel veranschaulicht mehrere Anfragen zum Abrufen von Installationsdaten für Desktop-Anwendungen. Ersetzen Sie den Wert applicationId durch die Produkt-ID für Ihre Desktop-Anwendung.

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>

Antwort

Antworttext

Wert Typ BESCHREIBUNG
Wert Array Ein Array von Objekten, die aggregierte Installationsdaten enthalten. Weitere Informationen zu den Daten in den einzelnen Objekten finden Sie in der folgenden Tabelle.
@nextLink Zeichenfolge Wenn zusätzliche Datenseiten vorhanden sind, enthält diese Zeichenfolge einen URI, den Sie verwenden können, um die nächste Seite mit Daten anzufordern. Dieser Wert wird beispielsweise zurückgegeben, wenn der oberste Parameter der Anforderung auf 10000 festgelegt ist, aber für die Abfrage mehr als 10000 Zeilen mit Installationsdaten vorhanden sind.
TotalCount int Die Gesamtanzahl der Zeilen im Datenergebnis für die Abfrage.

Elemente im Value-Array enthalten die folgenden Werte.

Wert Typ Beschreibung
Datum Zeichenfolge Das mit dem Wert der Installationsbasis verbundene Datum.
applicationId Zeichenfolge Die Produkt-ID der Desktop-Anwendung, für die Sie Installationsdaten abgerufen haben.
productName Zeichenfolge Der Anzeigename der Desktopanwendung, die von den Metadaten der zugeordneten ausführbaren Dateien abgeleitet wurde.
applicationVersion Zeichenfolge Die Version der ausführbaren Datei der Anwendung, die installiert wurde.
deviceType Zeichenfolge Eine der folgenden Zeichenfolgen, die den Gerätetyp angibt, auf dem die Desktop-Anwendung installiert ist:

  • PC
  • Server
  • Tablet
  • Unbekannt
Markt Zeichenfolge Der ISO-3166-Ländercode des Marktes, in dem die Desktop-Anwendung installiert ist.
osVersion Zeichenfolge Eine der folgenden Zeichenfolgen, die die Betriebssystemversion angibt, auf der die Desktopanwendung installiert ist:

  • Windows 7
  • Windows 8,1
  • Windows 10
  • Windows 11
  • Windows Server 2016
  • Windows Server 1709
  • Unbekannt
osRelease Zeichenfolge Eine der folgenden Zeichenfolgen, die die Betriebssystemversion oder den Flugring (als Untergruppe der Betriebssystemversion) angibt, auf dem die Desktop-Anwendung installiert ist.

Für Windows 11: Version 2110

Für Windows 10:

  • Version 1507
  • Version 1511
  • Version 1607
  • Version 1703
  • Version 1709
  • Vorschauversion
  • Insider Fast
  • Insider Slow

Für Windows Server 1709:

  • RTM

Für Windows Server 2016:

  • Version 1607

Für Windows 8,1:

  • Update 1

Für Windows 7:

  • Service Pack 1

Wenn die Betriebssystemversion oder der Flighting-Ring unbekannt ist, weist dieses Feld den Wert Unbekannt auf.
installBase Zahl Die Anzahl der einzelnen Geräte, auf denen das Produkt auf der angegebenen Aggregationsebene installiert ist.

Beispielantwort

Im folgenden Beispiel wird ein Beispiel für einen JSON-Antworttext für diese Anforderung veranschaulicht.

{
  "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
}