Abrufen von App-Rezensionen

  • Artikel

Verwenden Sie diese Methode in der Microsoft Store-Analyse-API, um Überprüfungsdaten im JSON-Format für einen bestimmten Datumsbereich und andere optionale Filter abzurufen. Diese Informationen sind auch im Bericht Überprüfungen im Partner Center verfügbar.

Nachdem Sie Rezensionen abgerufen haben, können Sie die Antwortinformationen für App-Rezensionen abrufen und Antworten auf App-Überprüfungsmethoden in der Microsoft Store-Überprüfungs-API senden, um programmgesteuert auf Rezensionen zu reagieren.

Voraussetzungen

Zur Verwendung dieser Methode sind folgende Schritte erforderlich:

  • Wenn Sie dies noch nicht getan haben, müssen Sie alle Voraussetzungen für die Microsoft Store-Analyse-API erfüllen.
  • 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. Wenn das Token abgelaufen ist, können Sie ein neues abrufen.

Anforderung

Anforderungssyntax

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

Anforderungsheader

Header type BESCHREIBUNG
Authorization Zeichenfolge Erforderlich. Das Azure AD-Zugriffstoken im Format Bearertoken<>.

Anforderungsparameter

Parameter Typ BESCHREIBUNG Erforderlich
applicationId Zeichenfolge Die Store-ID der App, für die Sie Überprüfungsdaten abrufen möchten. Ja
startDate date Das Startdatum im Datumsbereich der Rezensionsdaten, die abgerufen werden sollen. Als Standardeinstellung wird das aktuelle Datum festgelegt. Nein
endDate date Das Enddatum im Datumsbereich der Rezensionsdaten, die abgerufen werden sollen. Als Standardeinstellung wird das aktuelle Datum festgelegt. Nein
top INT Die Anzahl der Datenzeilen, die in der Anforderung zurückgegeben werden sollen. Der Maximal- und Standardwert ist 10.000, wenn nicht anders angegeben. Sind in der Abfrage keine weiteren Zeilen, enthält der Antworttext den Link „Weiter“, über den Sie die nächste Seite mit Daten anfordern können. Nein
skip INT Die Anzahl der Zeilen, die in der Abfrage übersprungen werden sollen. Verwenden Sie diesen Parameter, um große Datensätze durchzublättern. Beispielsweise rufen „top=10000“ und „skip=0“ die ersten 10.000 Datenzeilen ab, „top=10000“ und „skip=10000“ die nächsten 10.000 Datenzeilen usw. Nein
filter Zeichenfolge Mindestens eine Anweisung, die die Zeilen in der Antwort filtert. Weitere Informationen finden Sie unten im Abschnitt Filterfelder. Nein
orderby Zeichenfolge Eine Anweisung, die die Ergebnisdatenwerte anfordert. Die Syntax lautet orderby=field [order],field [order],.... Der Field-Parameter kann eine der folgenden Zeichenfolgen sein:
  • date
  • osVersion
  • Markt
  • Devicetype
  • isRevised
  • packageVersion
  • deviceModel
  • productFamily
  • deviceScreenResolution
  • isTouchEnabled
  • reviewerName
  • reviewTitle
  • reviewText
  • helpfulCount
  • notHelpfulCount
  • responseDate
  • responseText
  • deviceRAM
  • deviceStorageCapacity
  • Bewertung

Der Parameter order ist optional und kann asc oder desc sein, um die auf- oder absteigende Anordnung der einzelnen Felder anzugeben. Der Standardwert ist asc.

Hier ist ein Beispiel für orderby string: orderby=date,market

 Nein

Filterfelder

Der Parameter filter der Anforderung enthält mindestens eine Anweisung, die die Zeilen in der Antwort filtert. Jede Anweisung enthält ein Feld und einen Wert, das/der mit den Operatoren eq oder ne verknüpft ist. Einige Felder unterstützen darüber hinaus die Operatoren contains, gt, lt, ge und le. Anweisungen können mittels and oder or kombiniert werden.

Dies ist eine Beispielzeichenfolge für filter: filter=contains(reviewText,'great') and contains(reviewText,'ads') and deviceRAM lt 2048 and market eq 'US'

Eine Liste der unterstützten Felder und Operatoren für die einzelnen Felder finden Sie in der folgenden Tabelle. Zeichenfolgenwerte im Parameter filter müssen von einfachen Anführungszeichen eingeschlossen werden.

Felder Unterstützte Operatoren BESCHREIBUNG
market eq, ne Eine Zeichenfolge, die den ISO 3166-Ländercode des Gerätemarkts 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
  • Telefon
  • Konsolen-Xbox One
  • Konsolen-Xbox Series X
  • IoT
  • Holographic
  • Unbekannt
isRevised eq, ne Geben Sie true an, um nach Rezensionen zu filtern, die überprüft wurden. Geben Sie andernfalls false an.
packageVersion eq, ne Die Version des App-Pakets, das überprüft wurde.
deviceModel eq, ne Der Typ des Geräts, auf dem die App überprüft wurde.
productFamily eq, ne Eine der folgenden Zeichenfolgen:
  • PC
  • Tablet
  • Telefon
  • Wearable
  • Server
  • Gemeinsame
  • Andere
deviceRAM eq, ne, gt, lt, ge, le Der physische Arbeitsspeicher (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 Datenspeichers in GB.
isTouchEnabled eq, ne Geben Sie true an, um nach für die Toucheingabe aktivierten Geräten zu filtern; andernfalls false.
reviewerName eq, ne Der Name der Person, die die App rezensiert hat.
rating 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 nützlich markiert wurde.
notHelpfulCount eq, ne Die Häufigkeit, mit der die Rezension als nicht nützlich markiert wurde.
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 zeigen verschiedene Anforderungen für das Abrufen von Rezensionsdaten. Ersetzen Sie den applicationId-Wert durch die Store-ID Ihrer 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 Rezensionsdaten enthalten. Weitere Informationen zu den Daten in den einzelnen Objekten finden Sie unten im Abschnitt Rezensionswerte.
@nextLink Zeichenfolge Wenn weitere Seiten mit Daten vorhanden sind, enthält diese Zeichenfolge einen URI, mit dem Sie die nächste Seite mit Daten anfordern können. Beispielsweise wird dieser Wert zurückgegeben, wenn der Parameter top der Anforderung auf 10000 festgelegt ist, es jedoch mehr als 10.000 Zeilen mit Rezensionsdaten für die Abfrage gibt.
TotalCount INT Die Gesamtzahl der Zeilen im Datenergebnis für die Abfrage.

 

Rezensionswerte

Elemente im Array Value enthalten die folgenden Werte.

Wert Typ BESCHREIBUNG
date Zeichenfolge Das erste Datum im Datumsbereich für die Rezensionsdaten. Wenn die Anforderung einen einzelnen Tag angibt, ist dieses Datum dieser Wert. Wenn die Anforderung eine Woche, einen Monat oder einen anderen Datumsbereich angibt, 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.
market Zeichenfolge Der ISO 3166-Ländercode für den Markt, in dem die Rezension übermittelt wurde.
osVersion Zeichenfolge Die Version des Betriebssystems, auf dem 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 Rezension übermittelt wurde. Eine Liste der unterstützten Zeichenfolgen finden Sie oben im Abschnitt Filterfelder.
isRevised Boolean Der Wert true gibt an, dass die Rezension überprüft wurde; andernfalls false.
packageVersion Zeichenfolge Die Version des App-Pakets, das überprüft wurde.
deviceModel Zeichenfolge Der Typ des Geräts, auf dem die App überprüft wurde.
productFamily Zeichenfolge Der Name der Gerätefamilie. Eine Liste der unterstützten Zeichenfolgen finden Sie oben im Abschnitt Filterfelder.
deviceRAM number Der physische Arbeitsspeicher (RAM) in MB.
deviceScreenResolution Zeichenfolge Die Bildschirmauflösung des Geräts im Format "Breite x Höhe".
deviceStorageCapacity number Die Kapazität des primären Datenspeichers in GB.
isTouchEnabled Boolean Der Wert true gibt an, dass die Toucheingabe aktiviert ist; andernfalls false.
reviewerName Zeichenfolge Der Name der Person, die die App rezensiert hat.
rating number Die App-Bewertung in Sternen.
reviewTitle Zeichenfolge Der Titel der Rezension.
reviewText Zeichenfolge Der Textinhalt der Rezension.
helpfulCount number Die Häufigkeit, mit der die Rezension als nützlich markiert wurde.
notHelpfulCount number Die Häufigkeit, mit der die Rezension als nicht nützlich markiert wurde.
responseDate Zeichenfolge Das Datum, an dem eine Antwort übermittelt 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 Antwortinformationen für App-Überprüfungen abrufen und Antworten an App-Überprüfungsmethoden übermitteln .

Anforderungs- und Antwortbeispiel

Die folgenden Codeausschnitte zeigen einige Beispielanforderungen und JSON-Antworttexte für diese Anforderung.

Beispiel für eine Anforderung

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
}