Soumettre des réponses aux avis
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 .
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.
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.
- Obtenir 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 au format porteur<jeton>. |
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 | Boolean | 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
}
]
}
Response
Response body
| Valeur | Type | Description |
|---|---|---|
| Result | 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"
}
]
}