Obtenir des informations sur les réponses concernant les 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.
Si vous souhaitez répondre par programme à une révision client de votre application, vous pouvez utiliser cette méthode dans l’API de révisions du Microsoft Store pour déterminer d’abord si vous avez l’autorisation de répondre à la révision. Vous ne pouvez pas répondre aux avis soumis par les clients qui ont choisi de ne pas recevoir de réponses de révision. Une fois que vous avez confirmé que vous pouvez répondre à la révision, vous pouvez ensuite utiliser la méthode envoyer des réponses aux révisions d’application pour y répondre par programmation.
Prérequis
Pour utiliser cette méthode, vous devez d’abord effectuer les opérations suivantes :
- Si ce n’est pas déjà fait, remplissez toutes les conditions préalables relatives à l’API d’analyse de la Boutique Microsoft.
- 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 l’ID de la révision que vous souhaitez vérifier pour déterminer si vous pouvez y 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 |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v1.0/my/reviews/{reviewId}/apps/{applicationId}/responses/info |
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
| Paramètre | Type | Description | Obligatoire |
|---|---|---|---|
| applicationId | string | ID Store de l’application qui contient la révision pour laquelle vous souhaitez déterminer si vous pouvez répondre. L’ID store est disponible sur la page Identité de l’application dans 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. Si vous omettez ce paramètre, le corps de la réponse de cette méthode indique si vous disposez des autorisations nécessaires pour répondre aux révisions de l’application spécifiée. |
Non |
Exemple de requête
Les exemples suivants montrent comment utiliser cette méthode pour déterminer si vous pouvez répondre à une révision donnée.
GET https://manage.devcenter.microsoft.com/v1.0/my/reviews/6be543ff-1c9c-4534-aced-af8b4fbe0316/apps/9WZDNCRFJ3Q8/responses/info HTTP/1.1
Authorization: Bearer <your access token>
Response
Corps de réponse
| Valeur | Type | Description |
|------------|--------|-----------------------| | CanRespond | Boolean | La valeur true indique que vous pouvez répondre à la révision spécifiée ou que vous disposez des autorisations nécessaires pour répondre à n’importe quelle révision pour l’application spécifiée. Sinon, cette valeur est false. | | DefaultSupportEmail | string | Adresse e-mail de support de votre application, comme spécifié dans la description du Windows Store de votre application. Si vous n’avez pas spécifié d’adresse e-mail de support, ce champ est vide. |
Exemple de réponse
L’exemple suivant illustre un exemple de corps de réponse JSON pour cette requête.
{
"CanRespond": true,
"DefaultSupportEmail": "support@contoso.com"
}