Übermitteln von Antworten auf 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.

Verwenden Sie diese Methode in der Microsoft Store-Rezensions-API, um programmgesteuert auf Rezensionen Ihrer App zu reagieren. Wenn Sie diese Methode aufrufen, müssen Sie die IDs der Rezensionen angeben, auf die Sie antworten möchten. 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 ein Kunde eine Rezension übermittelt, kann er sich entscheiden, keine Antworten auf seine Rezension zu erhalten. Wenn Sie versuchen, auf eine Rezension zu antworten, für die der Kunde keine Antworten erhalten hat, zeigt der Antworttext dieser Methode an, dass der Antwortversuch nicht erfolgreich war. Bevor Sie diese Methode aufrufen, können Sie optional bestimmen, ob Sie auf eine bestimmte Rezension antworten dürfen, indem Sie die Get-Antwortinformationen für die Methode "App-Rezensionen " verwenden.

Hinweis

Zusätzlich zur programmgesteuerten Reaktion auf Rezensionen können Sie auch mithilfe des Partner Centers auf Rezensionen antworten.

Voraussetzungen

Um diese Methode zu verwenden, müssen Sie zuerst Folgendes ausführen:

Anforderung

Anforderungssyntax

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

Anforderungsheader

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

Anforderungsparameter

Diese Methode hat keine Anforderungsparameter.

Anforderungstext

Der Anforderungstext weist die folgenden Werte auf.

Wert type BESCHREIBUNG
Antworten array Ein Array von Objekten, die die Antwortdaten enthalten, die Sie übermitteln möchten. Weitere Informationen zu den Daten in den einzelnen Objekten finden Sie in der folgenden Tabelle.

Jedes Objekt im Antwortarray enthält die folgenden Werte.

Wert type Beschreibung Erforderlich
ApplicationId Zeichenfolge Die Store-ID der App mit der Rezension, auf die Sie antworten möchten. Die Store-ID ist auf der Seite "App-Identität" des Partner Centers 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. Ja
Responsetext Zeichenfolge Die Antwort, die Sie übermitteln möchten. Ihre Antwort muss diesen Richtlinien entsprechen. Ja
SupportEmail Zeichenfolge Die Support-E-Mail-Adresse Ihrer App, die der Kunde verwenden kann, um Sie direkt zu kontaktieren. Dies muss eine gültige E-Mail-Adresse sein. Ja
IsPublic Boolesch Wenn Sie "true" angeben, wird Ihre Antwort im Store-Eintrag Ihrer App direkt unter der Rezension des Kunden angezeigt und ist für alle Kunden sichtbar. Wenn Sie "false" angeben und der Benutzer den Empfang von E-Mail-Antworten nicht deaktiviert hat, wird Ihre Antwort per E-Mail an den Kunden gesendet, und er ist für andere Kunden im Store-Eintrag Ihrer App nicht sichtbar. Wenn Sie "false" angeben und der Benutzer den Empfang von E-Mail-Antworten deaktiviert hat, wird ein Fehler zurückgegeben. Ja

Anforderungsbeispiel

Im folgenden Beispiel wird veranschaulicht, wie Sie diese Methode verwenden, um Antworten an mehrere Rezensionen zu übermitteln.

POST https://manage.devcenter.microsoft.com/v1.0/my/reviews/responses HTTP/1.1
Authorization: Bearer <your access token>
Content-Type: application/json
{
  "Responses": [
    {
      "ApplicationId": "9WZDNCRFJ3Q8",
      "ReviewId": "6be543ff-1c9c-4534-aced-af8b4fbe0316",
      "ResponseText": "Thank you for pointing out this bug. I fixed it and published an update, you should have the fix soon",
      "SupportEmail": "support@contoso.com",
      "IsPublic": true
    },
    {
      "ApplicationId": "9NBLGGH1RP08",
      "ReviewId": "80c9671a-96c2-4278-bcbc-be0ce5a32a7c",
      "ResponseText": "Thank you for submitting your review. Can you tell more about what you were doing in the app when it froze? Thanks very much for your help.",
      "SupportEmail": "support@contoso.com",
      "IsPublic": false
    }
  ]
}

Antwort

Antworttext

Wert type BESCHREIBUNG
Result array Ein Array von Objekten, die Daten zu jeder von Ihnen übermittelten Antwort enthalten. Weitere Informationen zu den Daten in den einzelnen Objekten finden Sie in der folgenden Tabelle.

Jedes Objekt im Ergebnisarray enthält die folgenden Werte.

Wert type BESCHREIBUNG
ApplicationId Zeichenfolge Die Store-ID der App mit der Rezension, auf die Sie geantwortet haben. Ein Beispiel für die Store-ID ist 9WZDNCRFJ3Q8.
ReviewId Zeichenfolge Die ID der Rezension, auf die Sie geantwortet haben. Dies ist eine GUID.
Erfolgreich Zeichenfolge Der Wert "true " gibt an, dass Ihre Antwort erfolgreich gesendet wurde. Der Wert "false " gibt an, dass ihre Antwort nicht erfolgreich war.
FailureReason Zeichenfolge Wenn "Erfolgreich" falsch ist, enthält dieser Wert einen Grund für den Fehler. Wenn erfolgreich ist, ist dieser Wert leer.

Beispielantwort

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

{
  "Result": [
    {
      "ApplicationId": "9WZDNCRFJ3Q8",
      "ReviewId": "6be543ff-1c9c-4534-aced-af8b4fbe0316",
      "Successful": "true",
      "FailureReason": ""
    },
    {
      "ApplicationId": "9NBLGGH1RP08",
      "ReviewId": "80c9671a-96c2-4278-bcbc-be0ce5a32a7c",
      "Successful": "false",
      "FailureReason": "No Permission"
    }
  ]
}