Abrufen von App-Rezensionen
Verwenden Sie diese Methode in der Microsoft Store-Analyse-API, um Überprüfungsdaten im JSON-Format für einen bestimmten Zeitraum und andere optionale Filter abzurufen. Diese Informationen sind auch im Bericht "Rezensionen" im Partner Center verfügbar.
Nachdem Sie Rezensionen abgerufen haben, können Sie die Antwortinformationen für App-Rezensionen abrufen und Antworten auf App-Rezensionen methoden in der Microsoft Store-Rezensions-API senden, um programmgesteuert auf Rezensionen zu reagieren.
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/reviews |
Anforderungsheader
| Header | Typ | Beschreibung |
|---|---|---|
| Autorisierung | Zeichenfolge | Erforderlich. Das Azure AD-Zugriffstoken im Formular Bearer<-Token>. |
Anforderungsparameter
| Parameter | Typ | Beschreibung | Erforderlich |
|---|---|---|---|
| applicationId | Zeichenfolge | Die Store-ID der App, für die Sie Rezensionsdaten abrufen möchten. | Ja |
| startDate | date | Das Startdatum im Datumsbereich der abzurufenden Überprüfungsdaten. Die Standardeinstellung ist das aktuelle Datum. | No |
| endDate | date | Das Enddatum im Datumsbereich der abzurufenden Überprüfungsdaten. 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. Weitere Informationen finden Sie im Abschnitt zu Filterfelder weiter unten. | No |
| orderby | Zeichenfolge | Eine Anweisung, die die Ergebnisdatenwerte anordnet. Die Syntax ist orderby=Feld [order], Feld [order],.... Der Feld-Parameter kann eine der folgenden Zeichenfolgen sein:
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 |
No |
Filter (Felder)
Der Filter-Parameter der Anforderung enthält eine oder mehrere Anweisungen, die die Zeilen in der Antwort filtern. Jede Anweisung enthält ein Feld und einen Wert, die den Operatoren eq oder ne zugeordnet sind, und einige Felder unterstützen auch die Operatoren "contains", "gt", "lt", "ge" und "le". Anweisungen können mithilfe und oder oder kombiniert werden.
Hier ist eine Beispielfilterzeichenfolge: filter=contains(reviewText,'great') and contains(reviewText,'ads') and deviceRAM lt 2048 and market eq 'US'
Eine Liste der unterstützten Felder und Supportoperatoren für jedes Feld finden Sie in der folgenden Tabelle. Zeichenfolgenwerte müssen von einfachen Anführungszeichen im Filter-Parameter umgeben sein.
| Felder | Unterstützte Operatoren | Beschreibung |
|---|---|---|
| Markt | eq, ne | Eine Zeichenfolge, die den ISO 3166-Ländercode des Gerätemarktes enthält. |
| osVersion | eq, ne | Eine der folgenden Zeichenfolgen:
|
| deviceType | eq, ne | Eine der folgenden Zeichenfolgen:
|
| isRevised | eq, ne | Geben Sie true an, um nach Rezensionen zu filtern, die überarbeitet wurden; andernfalls "false". |
| packageVersion | eq, ne | Die Version des App-Pakets, das überprüft wurde. |
| deviceModel | eq, ne | Der Gerätetyp, auf dem die App überprüft wurde. |
| productFamily | eq, ne | Eine der folgenden Zeichenfolgen:
|
| deviceRAM | eq, ne, gt, lt, ge, le | Der physische RAM in MB. |
| deviceScreenResolution | eq, ne | Die Bildschirmauflösung des Geräts im Format "Breite x Höhe". |
| deviceStorageCapacity | eq, ne, gt, lt, ge, le | Die Kapazität des primären Speicherdatenträgers in GB. |
| isTouchEnabled | eq, ne | Geben Sie "true " an, um nach Geräten mit Toucheingabe zu filtern, andernfalls "false". |
| reviewerName | eq, ne | Der Name des Bearbeiters. |
| Bewertung | eq, ne, gt, lt, ge, le | Die App-Bewertung in Sternen. |
| reviewTitle | eq, ne, contains | Der Titel der Rezension. |
| reviewText | eq, ne, contains | Der Textinhalt der Rezension. |
| helpfulCount | eq, ne | Die Häufigkeit, mit der die Rezension als hilfreich markiert wurde. |
| notHelpfulCount | eq, ne | Die Häufigkeit, mit der die Rezension markiert wurde, ist nicht hilfreich. |
| responseDate | eq, ne | Das Datum, an dem die Antwort übermittelt wurde. |
| responseText | eq, ne, contains | Der Textinhalt der Antwort. |
| id | eq, ne | Die ID der Überprüfung (dies ist eine GUID). |
Anforderungsbeispiel
Die folgenden Beispiele veranschaulichen mehrere Anforderungen zum Abrufen von Überprüfungsdaten. Ersetzen Sie den applicationId-Wert durch die Store-ID für Ihre App.
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/reviews?applicationId=9NBLGGGZ5QDR&startDate=1/1/2015&endDate=2/1/2015&top=10&skip=0 HTTP/1.1
Authorization: Bearer <your access token>
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/reviews?applicationId=9NBLGGGZ5QDR&startDate=8/1/2015&endDate=8/31/2015&skip=0&filter=contains(reviewText,'great') and contains(reviewText,'ads') and deviceRAM lt 2048 and market eq 'US' HTTP/1.1
Authorization: Bearer <your access token>
Antwort
Antworttext
| Wert | Typ | BESCHREIBUNG |
|---|---|---|
| Wert | array | Ein Array von Objekten, die Überprüfungsdaten enthalten. Weitere Informationen zu den Daten in den einzelnen Objekten finden Sie im Abschnitt "Überprüfungswerte " weiter unten. |
| @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, es aber mehr als 10000 Zeilen mit Rezensionsdaten für die Abfrage gibt. |
| TotalCount | int | Die Gesamtanzahl der Zeilen im Datenergebnis für die Abfrage. |
Überprüfen von Werten
Elemente im Value-Array enthalten die folgenden Werte.
| Wert | Typ | Beschreibung |
|---|---|---|
| Datum | Zeichenfolge | Das erste Datum im Datumsbereich für die Überprüfungsdaten. Wenn die Anforderung einen einzelnen Tag angegeben hat, ist dieser Wert dieses Datum. Wenn die Anforderung eine Woche, einen Monat oder einen anderen Datumsbereich angegeben hat, ist dieser Wert das erste Datum in diesem Datumsbereich. |
| applicationId | Zeichenfolge | Die Store-ID der App, für die Sie Rezensionsdaten abrufen. |
| applicationName | Zeichenfolge | Der Anzeigename der App. |
| Markt | Zeichenfolge | Der ISO 3166-Ländercode des Marktes, in dem die Überprüfung eingereicht wurde. |
| osVersion | Zeichenfolge | Die Betriebssystemversion, für die die Rezension übermittelt wurde. Eine Liste der unterstützten Zeichenfolgen finden Sie oben im Abschnitt Filterfelder |
| deviceType | Zeichenfolge | Der Typ des Geräts, auf dem die Überprüfung übermittelt wurde. Eine Liste der unterstützten Zeichenfolgen finden Sie oben im Abschnitt Filterfelder |
| isRevised | Boolean | Der Wert "true " gibt an, dass die Überprüfung überarbeitet wurde; andernfalls "false". |
| packageVersion | Zeichenfolge | Die Version des App-Pakets, das überprüft wurde. |
| deviceModel | Zeichenfolge | Der Gerätetyp, auf dem die App überprüft wurde. |
| productFamily | Zeichenfolge | Der Gerätefamilienname. Eine Liste der unterstützten Zeichenfolgen finden Sie oben im Abschnitt Filterfelder |
| deviceRAM | Zahl | Der physische RAM in MB. |
| deviceScreenResolution | Zeichenfolge | Die Bildschirmauflösung des Geräts im Format "Breite x Höhe". |
| deviceStorageCapacity | Zahl | Die Kapazität des primären Speicherdatenträgers in GB. |
| isTouchEnabled | Boolean | Der Wert "true " gibt an, dass die Toucheingabe aktiviert ist; andernfalls "false". |
| reviewerName | Zeichenfolge | Der Name des Bearbeiters. |
| rating | Zahl | Die App-Bewertung in Sternen. |
| reviewTitle | Zeichenfolge | Der Titel der Rezension. |
| reviewText | Zeichenfolge | Der Textinhalt der Rezension. |
| helpfulCount | Zahl | Die Häufigkeit, mit der die Rezension als hilfreich markiert wurde. |
| notHelpfulCount | Zahl | Die Häufigkeit, mit der die Rezension markiert wurde, ist nicht hilfreich. |
| responseDate | Zeichenfolge | Das Datum, an dem eine Antwort gesendet wurde. |
| responseText | Zeichenfolge | Der Textinhalt der Antwort. |
| id | Zeichenfolge | Die ID der Überprüfung (dies ist eine GUID). Sie können diese ID in den Informationen zum Abrufen von Antwortinformationen für App-Rezensionen verwenden und Antworten an App-Rezensionsmethoden übermitteln. |
Beispiel für Anforderung und Antwort
Die folgenden Codeausschnitte zeigen beispielweise Anforderungs- und JSON-Antworttext für diese Anforderung.
Beispiel-Anfrage
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/reviews?applicationId=9WZDNCRFJB4P&top=10&skip=0
HTTP/1.1
Authorization: Bearer <your access token>
Beispiel für eine Antwort
{
"Value": [
{
"date": "3/5/2021 12:48:33 PM",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"market": "ES",
"osVersion": "Windows 10",
"deviceType": "PC",
"isRevised": false,
"packageVersion": "2.5.2.34894",
"reviewerName": "Jose Antonio",
"rating": 5,
"reviewTitle": "Contoso Demo",
"reviewText": "Un juego fantastico",
"helpfulCount": 3,
"notHelpfulCount": 0,
"id": "b5e27de9-2334-4849-d17d-4eae3e1e7aa9"
},
{
"date": "1/6/2021 8:41:42 AM",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"market": "TR",
"osVersion": "Windows 10",
"deviceType": "PC",
"isRevised": false,
"packageVersion": "2.5.2.34894",
"reviewerName": "fef",
"rating": 5,
"helpfulCount": 0,
"notHelpfulCount": 0,
"id": "f5d2510a-9796-45ee-01e5-6d5cc4550b09"
}
],
"TotalCount": 2
}