Obtenir des informations sur les réponses concernant les 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.

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 vous ne l’avez pas déjà fait, remplissez toutes les conditions préalables pour l’API d’analytique 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 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 dans le jeton> porteur<de formulaire.

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>

Réponse

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