Soumettre des réponses aux avisSubmit responses to reviews

Utilisez cette méthode dans l’API de révisions de Microsoft Store pour répondre par programmation aux révisions de votre application.Use this method in the Microsoft Store reviews API to programmatically respond to reviews of your app. Lorsque vous appelez cette méthode, vous devez spécifier les ID des révisions auxquelles vous souhaitez répondre.When you call this method, you must specify the IDs of the reviews you want to respond to. Les ID de révision sont disponibles dans les données de réponse de la méthode obtenir les révisions de l’application dans l’API Microsoft Store Analytics et dans le Téléchargement hors connexion du rapport de révisions.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.

Lorsqu’un client soumet une revue, il peut choisir de ne pas recevoir de réponse à sa révision.When a customer submits a review, they can choose not to receive responses to their review. Si vous essayez de répondre à une révision pour laquelle le client a choisi de ne pas recevoir de réponses, le corps de la réponse de cette méthode indique que la tentative de réponse a échoué.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. Avant d’appeler cette méthode, vous pouvez éventuellement déterminer si vous êtes autorisé à répondre à une révision donnée à l’aide de la méthode obtenir des informations de réponse pour les révisions de l’application .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.

Notes

Outre l’utilisation de cette méthode pour répondre par programmation aux révisions, vous pouvez également répondre aux révisions à l’aide de l’espace partenaires.In addition to using this method to programmatically respond to reviews, you can alternatively respond to reviews using Partner Center.

PrérequisPrerequisites

Pour utiliser cette méthode, vous devez d’abord effectuer les opérations suivantes :To use this method, you need to first do the following:

  • Si vous ne l’avez pas déjà fait, renseignez toutes les conditions préalables pour l’API de révisions de Microsoft Store.If you have not done so already, complete all the prerequisites for the Microsoft Store reviews API.
  • Obtenez un jeton d’accès Azure AD à utiliser dans l’en-tête de requête de cette méthode.Obtain an Azure AD access token to use in the request header for this method. Une fois que vous avez récupéré le jeton d’accès, vous avez 60 minutes pour l’utiliser avant qu’il n’expire.After you obtain an access token, you have 60 minutes to use it before it expires. Une fois le jeton arrivé à expiration, vous pouvez en obtenir un nouveau.After the token expires, you can obtain a new one.
  • Obtenir les ID des révisions auxquelles vous souhaitez répondre.Get the IDs of the reviews you want to respond to. Les ID de révision sont disponibles dans les données de réponse de la méthode obtenir les révisions de l’application dans l’API Microsoft Store Analytics et dans le Téléchargement hors connexion du rapport de révisions.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.

RequêteRequest

Syntaxe de la requêteRequest syntax

MéthodeMethod URI de requêteRequest URI
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/reviews/responses

En-tête de requêteRequest header

En-têteHeader TypeType DescriptionDescription
AutorisationAuthorization stringstring Obligatoire.Required. Jeton d’accès Azure AD sous la forme Bearer <jeton>.The Azure AD access token in the form Bearer <token>.

Paramètres de la demandeRequest parameters

Cette méthode n’a aucun paramètre de requête.This method has no request parameters.

Corps de la demandeRequest body

Le corps de la demande a les valeurs suivantes.The request body has the following values.

ValeurValue TypeType DescriptionDescription
RéponsesResponses tableauarray Tableau d’objets qui contiennent les données de réponse que vous souhaitez envoyer.An array of objects that contain the response data you want to submit. Pour plus d’informations sur les données de chaque objet, consultez le tableau suivant.For more information about the data in each object, see the following table.

Chaque objet dans le tableau de réponses contient les valeurs suivantes.Each object in the Responses array contains the following values.

ValeurValue TypeType DescriptionDescription ObligatoireRequired
ApplicationIdApplicationId stringstring ID de magasin de l’application avec la révision à laquelle vous souhaitez répondre.The Store ID of the app with the review you want to respond to. L’ID du magasin est disponible sur la page identité de l’application de l’espace partenaires.The Store ID is available on the App identity page of Partner Center. Exemple d’ID Windows Store : 9WZDNCRFJ3Q8.An example Store ID is 9WZDNCRFJ3Q8. OuiYes
ReviewIdReviewId stringstring ID de la révision à laquelle vous souhaitez répondre (il s’agit d’un GUID).The ID of the review you want to respond to (this is a GUID). Les ID de révision sont disponibles dans les données de réponse de la méthode obtenir les révisions de l’application dans l’API Microsoft Store Analytics et dans le Téléchargement hors connexion du rapport de révisions.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. OuiYes
ResponseTextResponseText stringstring La réponse que vous souhaitez envoyer.The response you want to submit. Votre réponse doit suivre ces instructions.Your response must follow these guidelines. OuiYes
SupportEmailSupportEmail stringstring L’adresse de messagerie du support technique de votre application, que le client peut utiliser pour vous contacter directement.Your app's support email address, which the customer can use to contact you directly. Il doit s’agir d’une adresse de messagerie valide.This must be a valid email address. OuiYes
IsPublicIsPublic BooleanBoolean Si vous spécifiez la valeur true, votre réponse sera affichée dans la liste des boutiques de votre application, directement sous la revue du client, et sera visible pour tous les clients.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. Si vous spécifiez false et que l’utilisateur n’a pas refusé de recevoir des réponses par courrier électronique, votre réponse sera envoyée au client par courrier électronique et ne sera pas visible pour les autres clients figurant dans la liste des boutiques de votre application.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. Si vous spécifiez false et que l’utilisateur a refusé de recevoir des réponses par courrier électronique, une erreur est retournée.If you specify false and the user has opted out of receiving email responses, an error will be returned. OuiYes

Exemple de requêteRequest example

L’exemple suivant montre comment utiliser cette méthode pour envoyer des réponses à plusieurs révisions.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
    }
  ]
}

responseResponse

Response bodyResponse body

ValeurValue TypeType DescriptionDescription
RésultatsResult tableauarray Tableau d’objets qui contiennent les données relatives à chaque réponse que vous avez envoyée.An array of objects that contain data about each response you submitted. Pour plus d’informations sur les données de chaque objet, consultez le tableau suivant.For more information about the data in each object, see the following table.

Chaque objet du tableau de résultats contient les valeurs suivantes.Each object in the Result array contains the following values.

ValeurValue TypeType DescriptionDescription
ApplicationIdApplicationId stringstring ID de magasin de l’application avec la révision à laquelle vous avez répondu.The Store ID of the app with the review you responded to. Exemple d’ID Windows Store : 9WZDNCRFJ3Q8.An example Store ID is 9WZDNCRFJ3Q8.
ReviewIdReviewId stringstring ID de la révision à laquelle vous avez répondu.The ID of the review you responded to. Il s’agit d’un GUID.This is a GUID.
RéussiteSuccessful stringstring La valeur true indique que votre réponse a été envoyée avec succès.The value true indicates that your response was sent successfully. La valeur false indique que votre réponse a échoué.The value false indicates that your response was unsuccessful.
FailureReasonFailureReason stringstring En casde réussite , cette valeur contient la raison de l’échec.If Successful is false, this value contains a reason for the failure. En cas de réussite , cette valeur est vide.If Successful is true, this value is empty.

Exemple de réponseResponse example

L’exemple suivant représente un corps de réponse JSON pour cette requête.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"
    }
  ]
}