Soumettre des réponses aux avis

2025-06-10

Important

L’API d’évaluations Microsoft Store, comme décrit dans cette rubrique, ne fonctionne pas actuellement. Au lieu d’utiliser les API, vous pouvez effectuer la ou les mêmes tâches en en utilisant le centre de partenaires.

Utilisez cette méthode dans l’API de révisions du Microsoft Store pour répondre par programmation aux révisions de votre application. Lorsque vous appelez cette méthode, vous devez spécifier les ID des révisions auxquelles vous souhaitez répondre. Les ID de révision sont disponibles dans les données de réponse de la méthode obtenir les avis sur l'application dans l’API d’analyse du Microsoft Store et dans le téléchargement hors ligne du rapport des avis .

Lorsqu’un client envoie une révision, il peut choisir de ne pas recevoir de réponses à son avis. 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 réponse de cette méthode indique que la tentative de réponse a échoué. Avant d’appeler cette méthode, vous pouvez déterminer si vous êtes autorisé à répondre à une évaluation donnée en utilisant la méthode obtenir des informations de réponse pour les critiques d’application.

Remarque

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.

Conditions préalables

Pour utiliser cette méthode, vous devez d’abord effectuer les opérations suivantes :

Si vous ne l’avez pas déjà fait, remplissez toutes les conditions préalables pour l’API de révisions du Microsoft Store.
Obtenez un jeton d’accès Azure AD à utiliser dans l’en-tête de requête pour cette méthode. 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. Une fois le jeton expiré, vous pouvez en obtenir un nouveau.
Obtenez les ID des révisions auxquelles vous souhaitez répondre. Les ID de révision sont disponibles dans les données de réponse de la méthode obtenir les avis sur l'application dans l’API d’analyse du Microsoft Store et dans le téléchargement hors ligne du rapport des avis .

Requête

Syntaxe de la requête

Méthode	URI de la requête
PUBLIER	`https://manage.devcenter.microsoft.com/v1.0/my/reviews/responses`

En-tête de requête

En-tête de page	Catégorie	Descriptif
Autorisation	ficelle	Obligatoire. Le jeton d’accès Azure AD sous la forme Bearer<token>.

Paramètres de la demande

Cette méthode n’a aucun paramètre de requête.

Corps de la requête

Le corps de la requête a les valeurs suivantes.

Valeur	Catégorie	Descriptif
Réponses	tableau	Tableau d’objets qui contiennent les données de réponse que vous souhaitez envoyer. Pour plus d’informations sur les données de chaque objet, consultez le tableau suivant.

Chaque objet du tableau Réponses contient les valeurs suivantes.

Valeur	Catégorie	Descriptif	Obligatoire
ApplicationId	ficelle	ID Store de l’application avec la révision à laquelle vous souhaitez répondre. L’ID de Store est disponible sur la page d’identité de l’application dans l’Espace Partenaires. Un exemple d’ID store est 9WZDNCRFJ3Q8.	Oui
ReviewId	ficelle	ID de la révision à laquelle vous souhaitez répondre (il s’agit d’un GUID). Les ID de révision sont disponibles dans les données de réponse de la méthode obtenir les avis sur l'application dans l’API d’analyse du Microsoft Store et dans le téléchargement hors ligne du rapport des avis .	Oui
Texte de réponse	ficelle	Réponse à envoyer. Votre réponse doit suivre ces instructions.	Oui
Courriel de Support	ficelle	Adresse e-mail de support de votre application, que le client peut utiliser pour vous contacter directement. Il doit s’agir d’une adresse e-mail valide.	Oui
IsPublic	Booléen	Si vous spécifiez la valeur true, votre réponse s’affiche dans la description du Windows Store de votre application, directement sous l’avis du client et sera visible pour tous les clients. Si vous spécifiez false et que l’utilisateur n’a pas refusé de recevoir des réponses par e-mail, votre réponse sera envoyée au client par e-mail et elle ne sera pas visible par d’autres clients dans la description du Windows Store de votre application. Si vous spécifiez false et que l’utilisateur a refusé de recevoir des réponses par e-mail, une erreur est retournée.	Oui

Exemple de requête

L’exemple suivant montre comment utiliser cette méthode pour envoyer des réponses à plusieurs révisions.

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

Réponse

Corps de réponse

Valeur	Catégorie	Descriptif
Résultat	tableau	Tableau d’objets qui contiennent des données sur chaque réponse que vous avez envoyée. Pour plus d’informations sur les données de chaque objet, consultez le tableau suivant.

Chaque objet du tableau Result contient les valeurs suivantes.

Valeur	Catégorie	Descriptif
ApplicationId	ficelle	L'ID Store de l'application avec l'avis auquel vous avez répondu. Un exemple d’ID store est 9WZDNCRFJ3Q8.
ReviewId	ficelle	ID de la révision à laquelle vous avez répondu. Il s’agit d’un GUID.
Réussi/Réussie	ficelle	La valeur true indique que votre réponse a été envoyée avec succès. La valeur false indique que votre réponse a échoué.
Raison de l'échec	ficelle	Si succès est faux, cette valeur contient une raison de l’échec. Si est un succès et est true, cette valeur est vide.

Exemple de réponse

L’exemple suivant illustre un exemple de corps de réponse JSON pour cette requête.

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