Übermitteln von Antworten auf RezensionenSubmit responses to reviews

Verwenden Sie diese Methode in der Microsoft Store Reviews-API, um Programm gesteuert auf Überprüfungen Ihrer APP zu reagieren.Use this method in the Microsoft Store reviews API to programmatically respond to reviews of your app. Wenn Sie diese Methode aufgerufen haben, müssen Sie die IDs der Reviews angeben, auf die Sie reagieren möchten.When you call this method, you must specify the IDs of the reviews you want to respond to. Überprüfungs-IDs sind in den Antwortdaten der Methode Get App Reviews in der Microsoft Store Analytics-API und im Offline Download des Berichts Reviewsverfügbar.Review IDs are available in the response data of the get app reviews method in the Microsoft Store analytics API and in the offline download of the Reviews report.

Wenn ein Kunde einen Review sendet, kann er auswählen, dass er keine Antworten auf seine Überprüfung erhält.When a customer submits a review, they can choose not to receive responses to their review. Wenn Sie versuchen, auf eine Überprüfung zu reagieren, für die der Kunde keinen Empfang von Antworten gewählt hat, gibt der Antworttext dieser Methode an, dass der Antwort Versuch nicht erfolgreich war.If you try to respond to a review for which the customer chose not to receive responses, the response body of this method will indicate that the response attempt was unsuccessful. Bevor Sie diese Methode aufrufen, können Sie optional ermitteln, ob Sie auf eine bestimmte Überprüfung Antworten können, indem Sie die Methode Get Response Info for App Reviews verwenden.Before calling this method, you can optionally determine whether you are allowed to respond to a given review by using the get response info for app reviews method.

Hinweis

Mit dieser Methode können Sie nicht nur Programm gesteuert auf Überprüfungen reagieren, sondern auch mithilfe von Partner Centerauf Überprüfungen reagieren.In addition to using this method to programmatically respond to reviews, you can alternatively respond to reviews using Partner Center.

VoraussetzungenPrerequisites

Zur Verwendung dieser Methode sind folgende Schritte erforderlich:To use this method, you need to first do the following:

  • Wenn Sie dies nicht bereits getan haben, müssen Sie alle Voraussetzungen für die Microsoft Store Reviews-API erfüllen.If you have not done so already, complete all the prerequisites for the Microsoft Store reviews API.
  • Rufen Sie ein Azure AD-Zugriffstoken ab, das im Anforderungsheader für diese Methode verwendet wird.Obtain an Azure AD access token to use in the request header for this method. Nachdem Sie ein Zugriffstoken erhalten haben, haben Sie 60 Minuten Zeit, es zu verwenden, bevor es abläuft.After you obtain an access token, you have 60 minutes to use it before it expires. Wenn das Token abgelaufen ist, können Sie ein neues abrufen.After the token expires, you can obtain a new one.
  • Holen Sie sich die IDs der Reviews, auf die Sie reagieren möchten.Get the IDs of the reviews you want to respond to. Überprüfungs-IDs sind in den Antwortdaten der Methode Get App Reviews in der Microsoft Store Analytics-API und im Offline Download des Berichts Reviewsverfügbar.Review IDs are available in the response data of the get app reviews method in the Microsoft Store analytics API and in the offline download of the Reviews report.

AnforderungRequest

AnforderungssyntaxRequest syntax

MethodeMethod Anforderungs-URIRequest URI
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/reviews/responses

AnforderungsheaderRequest header

HeaderHeader typeType BESCHREIBUNGDescription
AuthorizationAuthorization Zeichenfolgestring Erforderlich.Required. Das Azure AD-Zugriffstoken im Format Bearer <token>.The Azure AD access token in the form Bearer <token>.

AnforderungsparameterRequest parameters

Diese Methode hat keine Anforderungs Parameter.This method has no request parameters.

AnforderungstextRequest body

Der Anforderungs Text weist die folgenden Werte auf.The request body has the following values.

WertValue typeType BESCHREIBUNGDescription
AntwortenResponses arrayarray Ein Array von-Objekten, die die Antwortdaten enthalten, die Sie übermitteln möchten.An array of objects that contain the response data you want to submit. Weitere Informationen zu den Daten in den einzelnen Objekten finden Sie in der folgenden Tabelle.For more information about the data in each object, see the following table.

Jedes Objekt im Array " Antworten " enthält die folgenden Werte:Each object in the Responses array contains the following values.

WertValue typeType BESCHREIBUNGDescription ErforderlichRequired
ApplicationIdApplicationId Zeichenfolgestring Die Speicher-ID der APP mit der Überprüfung, auf die Sie reagieren möchten.The Store ID of the app with the review you want to respond to. Die Store-ID ist auf der Seite App-Identität von Partner Center verfügbar.The Store ID is available on the App identity page of Partner Center. Beispiel für eine Store-ID: 9WZDNCRFJ3Q8.An example Store ID is 9WZDNCRFJ3Q8. JaYes
ReviewidReviewId Zeichenfolgestring Die ID der Überprüfung, auf die Sie reagieren möchten (Dies ist eine GUID).The ID of the review you want to respond to (this is a GUID). Überprüfungs-IDs sind in den Antwortdaten der Methode Get App Reviews in der Microsoft Store Analytics-API und im Offline Download des Berichts Reviewsverfügbar.Review IDs are available in the response data of the get app reviews method in the Microsoft Store analytics API and in the offline download of the Reviews report. JaYes
Response TextResponseText Zeichenfolgestring Die Antwort, die Sie übermitteln möchten.The response you want to submit. Ihre Antwort muss den folgenden Richtlinienentsprechen.Your response must follow these guidelines. JaYes
SupportemailSupportEmail Zeichenfolgestring Die Support-e-Mail-Adresse Ihrer APP, die der Kunde verwenden kann, um Sie direkt zu kontaktieren.Your app's support email address, which the customer can use to contact you directly. Dies muss eine gültige e-Mail-Adresse sein.This must be a valid email address. JaYes
IsPublicIsPublic BooleanBoolean Wenn Sie " true" angeben, wird die Antwort in der Store-Liste Ihrer APP direkt unterhalb der Kunden Überprüfung angezeigt und ist für alle Kunden sichtbar.If you specify true, your response will be displayed in your app's Store listing, directly below the customer's review, and will be visible to all customers. Wenn Sie " false " angeben und der Benutzer keine e-Mail-Antworten erhalten hat, wird die Antwort per e-Mail an den Kunden gesendet und ist nicht für andere Kunden in der Store-Liste Ihrer APP sichtbar.If you specify false and the user hasn't opted out of receiving email responses, your response will be sent to the customer via email, and it will not be visible to other customers in your app's Store listing. Wenn Sie false angeben und der Benutzer keine e-Mail-Antworten erhalten hat, wird ein Fehler zurückgegeben.If you specify false and the user has opted out of receiving email responses, an error will be returned. JaYes

AnforderungsbeispielRequest example

Im folgenden Beispiel wird veranschaulicht, wie diese Methode verwendet wird, um Antworten an verschiedene Überprüfungen zu senden.The following example demonstrates how to use this method to submit responses to several reviews.

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
    }
  ]
}

AntwortResponse

AntworttextResponse body

WertValue typeType BESCHREIBUNGDescription
ErgebnisResult arrayarray Ein Array von-Objekten, die Daten zu jeder von Ihnen übermittelten Antwort enthalten.An array of objects that contain data about each response you submitted. Weitere Informationen zu den Daten in den einzelnen Objekten finden Sie in der folgenden Tabelle.For more information about the data in each object, see the following table.

Jedes-Objekt im Ergebnis Array enthält die folgenden Werte.Each object in the Result array contains the following values.

WertValue typeType BESCHREIBUNGDescription
ApplicationIdApplicationId Zeichenfolgestring Die Speicher-ID der APP mit der Überprüfung, auf die Sie geantwortet haben.The Store ID of the app with the review you responded to. Beispiel für eine Store-ID: 9WZDNCRFJ3Q8.An example Store ID is 9WZDNCRFJ3Q8.
ReviewidReviewId Zeichenfolgestring Die ID der Überprüfung, auf die Sie geantwortet haben.The ID of the review you responded to. Dies ist eine GUID.This is a GUID.
ErfolgreichSuccessful Zeichenfolgestring Der Wert true gibt an, dass die Antwort erfolgreich gesendet wurde.The value true indicates that your response was sent successfully. Der Wert false gibt an, dass die Antwort nicht erfolgreich war.The value false indicates that your response was unsuccessful.
FailureReasonFailureReason Zeichenfolgestring Wenn erfolgreich falseist, enthält dieser Wert einen Grund für den Fehler.If Successful is false, this value contains a reason for the failure. Wenn erfolgreich trueist, ist dieser Wert leer.If Successful is true, this value is empty.

BeispielantwortResponse example

Das folgende Beispiel zeigt ein Beispiel für einen JSON-Antworttext für diese Anforderung.The following example demonstrates an example JSON response body for this request.

{
  "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"
    }
  ]
}