Soumettre des réponses aux avis

  • Article

Important

L’API de révision du Microsoft Store, comme indiqué dans cette rubrique, n’est actuellement pas en état de fonctionnement. Au lieu d’utiliser les API, vous pouvez effectuer la ou les mêmes tâches à l’aide de l’Espace 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 get app reviews method in the Microsoft Store analytics API and in the offline download of the Reviews report.

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 éventuellement déterminer si vous êtes autorisé à répondre à une révision donnée à l’aide des informations de réponse pour la méthode des révisions d’application .

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.

Prérequis

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 get app reviews method in the Microsoft Store analytics API and in the offline download of the Reviews report.

Requête

Syntaxe de la requête

Méthode URI de demande
POST https://manage.devcenter.microsoft.com/v1.0/my/reviews/responses

En-tête de requête

En-tête Type Description
Autorisation string Obligatoire. Jeton d’accès Azure AD dans le jeton> porteur<de formulaire.

Paramètres de la demande

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

Corps de la demande

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

Valeur Type Description
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 Type Description Obligatoire
ApplicationId string ID Store de l’application avec la révision à laquelle vous souhaitez répondre. L’ID store est disponible sur la page Identité de l’application de l’Espace partenaires. Un exemple d’ID store est 9WZDNCRFJ3Q8. Oui
ReviewId string 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 get app reviews method in the Microsoft Store analytics API and in the offline download of the Reviews report. Oui
ResponseText string Réponse à envoyer. Votre réponse doit suivre ces instructions. Oui
SupportEmail string 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

Response body

Valeur Type Description
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 Type Description
ApplicationId string ID Store de l’application avec la révision à laquelle vous avez répondu. Un exemple d’ID store est 9WZDNCRFJ3Q8.
ReviewId string ID de la révision à laquelle vous avez répondu. Il s’agit d’un GUID.
Réussite string 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é.
FailureReason string Si la valeur réussit est false, cette valeur contient une raison de l’échec. Si la valeur réussit 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"
    }
  ]
}