Abrufen von App-Rezensionen

Artikel
07/05/2024

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: date osVersion market deviceType isRevised packageVersion deviceModel productFamily deviceScreenResolution isTouchEnabled reviewerName reviewTitle reviewText helpfulCount notHelpfulCount responseDate responseText deviceRAM deviceStorageCapacity rating 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: Windows Phone 7.5 Windows Phone 8 Windows Phone 8.1 Windows Phone 10 Windows 8 Windows 8,1 Windows 10 Windows 11 Unbekannt
deviceType	eq, ne	Eine der folgenden Zeichenfolgen: PC Telefonnummer Konsolen-Xbox One Konsolen-Xbox Series X IoT Holographisch Unbekannt
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: PC Tablet Telefonnummer Tragbar Server Kollaborativ Andere
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
}

Freigeben über

Abrufen von App-Rezensionen

Voraussetzungen

Anfordern

Anforderungssyntax

Anforderungsheader

Anforderungsparameter

Filter (Felder)

Anforderungsbeispiel

Antwort

Antworttext

Überprüfen von Werten

Beispiel für Anforderung und Antwort

Beispiel-Anfrage

Beispiel für eine Antwort

Feedback

Feedback

Zusätzliche Ressourcen

Freigeben über

Abrufen von App-Rezensionen

Voraussetzungen

Anfordern

Anforderungssyntax

Anforderungsheader

Anforderungsparameter

Filter (Felder)

Anforderungsbeispiel

Antwort

Antworttext

Überprüfen von Werten

Beispiel für Anforderung und Antwort

Beispiel-Anfrage

Beispiel für eine Antwort

Zugehörige Themen

Feedback

Feedback

Zusätzliche Ressourcen