Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Verwenden Sie diesen REST-URI, um aggregierte Installationsdaten im JSON-Format für eine Desktopanwendung abzurufen, die Sie dem Windows Desktop Application-Programmhinzugefügt haben. Mit diesem URI können Sie Installationsdaten während eines bestimmten Datumsbereichs und mit weiteren optionalen Filtern abrufen. Diese Informationen sind auch im Bericht Installs für Desktopanwendungen im Partner Center verfügbar.
Voraussetzungen
Um diese Methode zu verwenden, müssen Sie zuerst Folgendes ausführen:
- Falls noch nicht geschehen, füllen Sie alle Voraussetzungen für die Microsoft Store-Analyse-API aus.
- Holen Sie sich ein Azure AD-Zugriffstoken, um es im Header der Anfrage für diese Methode zu verwenden. Nachdem Sie ein Zugriffstoken abgerufen haben, müssen Sie es 60 Minuten verwenden, bevor es abläuft. Nachdem das Token abgelaufen ist, können Sie eine neue abrufen.
Anfrage
Anforderungssyntax
| Methode | Anforderungs-URI |
|---|---|
| ERHALTEN/Bekommen | https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/installbasedaily |
Anforderungs-Kopfzeile
| Kopfzeile | Typ | BESCHREIBUNG |
|---|---|---|
| Autorisierung | Schnur | Erforderlich. Das Azure AD-Zugriffstoken in der Form Bearer<token>. |
Anforderungsparameter
| Parameter | Typ | BESCHREIBUNG | Erforderlich |
|---|---|---|---|
| Anwendungs-ID | Schnur | Die Produkt-ID der Desktopanwendung, für die Sie Installationsdaten abrufen möchten. Um die Produkt-ID einer Desktopanwendung abzurufen, öffnen Sie jeden Analysebericht für Ihre Desktopanwendung im Partner Center (z. B. den Bericht "Installationen") und rufen Sie die Produkt-ID aus der URL ab, indem Sie mit dem Mauszeiger auf den Link zeigen, um die Details anzuzeigen. | Ja |
| Startdatum | Datum | Das Startdatum im Datumsbereich der Installationsdaten, die abgerufen werden sollen. Der Standardwert ist 90 Tage vor dem aktuellen Datum. | Nein |
| Enddatum | Datum | Das Enddatum im Datumsbereich der Installationsdaten, die abzurufen sind. Der Standardwert ist das aktuelle Datum. | Nein |
| Nach oben | INT | Die Anzahl der Datenzeilen, die in der Anforderung zurückgegeben werden sollen. Der Maximalwert und der Standardwert, wenn nicht angegeben ist, 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 |
| hüpfen | INT | Die Anzahl der Zeilen, die in der Abfrage übersprungen werden sollen. Verwenden Sie diesen Parameter, um große Datensätze zu durchblättern. 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 | Schnur | Eine oder mehrere Aussagen, die die Zeilen in der Antwort filtern. Jede Anweisung enthält einen Feldnamen aus dem Antworttext und Wert, die dem Eq - oder ne-Operator zugeordnet sind, und Anweisungen können mit undoder oder kombiniert werden. Zeichenfolgenwerte müssen von einfachen Anführungszeichen im Filterparameter umgeben sein. Sie können die folgenden Felder aus dem Antworttext angeben:
|
Nein |
| Sortierung nach | Schnur | Eine Anweisung, die die Ergebnisdatenwerte für jede Installation sortiert. Die Syntax ist orderby=field [order],field [order],.... Das Feld Parameter kann eines der folgenden Felder aus dem Antworttext sein:
Der Order-Parameter ist optional und kann asc oder desc sein, um die aufsteigende oder absteigende Reihenfolge für jedes Feld anzugeben. Der Standardwert ist asc. Hier ist ein Beispiel für eine Orderby-Zeichenfolge : orderby=date,market |
Nein |
| GruppierenNach | Schnur | Eine Aussage, die die Datenaggregation nur auf die angegebenen Felder anwendet. Sie können die folgenden Felder aus dem Antworttext angeben:
Die zurückgegebenen Datenzeilen enthalten die im groupby Parameter angegebenen Felder sowie folgendes:
|
Nein |
Beispielanfrage
Im folgenden Beispiel werden mehrere Anforderungen zum Abrufen von Installationsdaten für Desktopanwendungen veranschaulicht. Ersetzen Sie den Wert "applicationId" durch die Produkt-ID für Ihre Desktopanwendung.
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
Antwortkörper
| 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 | Schnur | 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 z. B. zurückgegeben, wenn der top Parameter der Anforderung auf 10000 festgelegt ist, es jedoch mehr als 10000 Zeilen mit Installationsdaten für die Abfrage gibt. |
| Gesamtzahl | INT | Die Gesamtanzahl der Zeilen des Abfrageergebnisses. |
Elemente im Value-Array enthalten die folgenden Werte.
| Wert | Typ | BESCHREIBUNG |
|---|---|---|
| Datum | Schnur | Das Datum, das dem Installationsbasiswert zugeordnet ist. |
| Anwendungs-ID | Schnur | Die Produkt-ID der Desktopanwendung, für die Sie Installationsdaten abgerufen haben. |
| Produktname | Schnur | Der Anzeigename der Desktop-Anwendung, wie er aus den Metadaten der zugeordneten ausführbaren Datei(en) abgeleitet wird. |
| Anwendungsversion | Schnur | Die Version der ausführbaren Anwendung, die installiert wurde. |
| Gerätetyp | Schnur | Eine der folgenden Zeichenfolgen, die den Gerätetyp angibt, auf dem die Desktopanwendung installiert ist:
|
| Markt | Schnur | Der ISO 3166-Ländercode des Marktes, in dem die Desktopanwendung installiert ist. |
| osVersion | Schnur | Eine der folgenden Zeichenfolgen, die die Betriebssystemversion angibt, auf der die Desktopanwendung installiert ist:
|
| osVeröffentlichung | Schnur | Eine der folgenden Zeichenfolgen, die die Betriebssystemversion oder den Flighting-Ring (als Teilmenge innerhalb der Betriebssystemversion) angibt, auf dem die Desktopanwendung installiert ist. Für Windows 11: Version 2110 Für Windows 10:
Für Windows Server 1709:
Für Windows Server 2016:
Für Windows 8.1:
Für Windows 7:
Wenn die Betriebssystemversion oder der Flighting-Ring unbekannt ist, weist dieses Feld den Wert Unbekannt auf. |
| installBase | Zahl | Die Anzahl der unterschiedlichen Geräte, auf denen das Produkt auf der angegebenen Aggregationsebene installiert wurde. |
Antwortbeispiel
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
}