Abrufen von Antwortinformationen für Rezensionen

  • Artikel

Wichtig

Die Microsoft Store-Rezensions-API, wie in diesem Thema beschrieben, befindet sich derzeit nicht im Arbeitszustand. Anstatt die APIs zu verwenden, können Sie dieselbe Aufgabe(n) mithilfe des Partner Centers erreichen.

Wenn Sie programmgesteuert auf eine Kundenrezensionen Ihrer App reagieren möchten, können Sie diese Methode in der Microsoft Store-Rezensions-API verwenden, um zuerst zu bestimmen, ob Sie über die Berechtigung zum Beantworten der Rezension verfügen. Sie können nicht auf Rezensionen antworten, die von Kunden eingereicht wurden, die keine Rezensionsantworten erhalten haben. Nachdem Sie bestätigt haben, dass Sie auf die Rezension antworten können, können Sie die Übermittlungsantworten für die Methode "App-Rezensionen" verwenden, um programmgesteuert darauf zu reagieren.

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.
  • Rufen Sie ein Azure AD-Zugriffstoken ab, das im Anforderungsheader für diese Methode verwendet werden soll. 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.
  • Rufen Sie die ID der Rezension ab, die Sie überprüfen möchten, um zu bestimmen, ob Sie darauf antworten können. Prüf-IDs sind in den Antwortdaten der Get-App-Rezensionsmethode in der Microsoft Store-Analyse-API und im Offlinedownload des Berichts "Rezensionen" verfügbar.

Anforderung

Anforderungssyntax

Methode Anforderungs-URI
GET https://manage.devcenter.microsoft.com/v1.0/my/reviews/{reviewId}/apps/{applicationId}/responses/info

Anforderungsheader

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

Anforderungsparameter

Parameter type Beschreibung Erforderlich
applicationId Zeichenfolge Die Store-ID der App, die die Rezension enthält, für die Sie bestimmen möchten, ob Sie antworten können. Die Store-ID ist auf der Seite "App-Identität" im Partner Center verfügbar. Ein Beispiel für die Store-ID ist 9WZDNCRFJ3Q8. Ja
reviewId Zeichenfolge Die ID der Rezension, auf die Sie antworten möchten (dies ist eine GUID). Prüf-IDs sind in den Antwortdaten der Get-App-Rezensionsmethode in der Microsoft Store-Analyse-API und im Offlinedownload des Berichts "Rezensionen" verfügbar.
Wenn Sie diesen Parameter weglassen, gibt der Antworttext für diese Methode an, ob Sie über die Berechtigung zum Beantworten von Rezensionen für die angegebene App verfügen.		 Nein

Anforderungsbeispiel

Die folgenden Beispiele, wie Sie diese Methode verwenden, um zu bestimmen, ob Sie auf eine bestimmte Rezension antworten können.

GET https://manage.devcenter.microsoft.com/v1.0/my/reviews/6be543ff-1c9c-4534-aced-af8b4fbe0316/apps/9WZDNCRFJ3Q8/responses/info HTTP/1.1
Authorization: Bearer <your access token>

Antwort

Antworttext

| Wert | Typ | Beschreibung |
|------------|--------|-----------------------| | CanRespond | Boolescher Wert | Der Wert "true " gibt an, dass Sie auf die angegebene Rezension antworten können oder dass Sie über die Berechtigung verfügen, auf eine Beliebige Rezension für die angegebene App zu antworten. Andernfalls ist dieser Wert "false". | | DefaultSupportEmail | Zeichenfolge | Die Support-E-Mail-Adresse Ihrer App, wie im Store-Eintrag Ihrer App angegeben. Wenn Sie keine Support-E-Mail-Adresse angegeben haben, ist dieses Feld leer. |  

Beispielantwort

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

{
  "CanRespond": true,
  "DefaultSupportEmail": "support@contoso.com"
}