Répondre aux révisions à l’aide des services du Windows Store

  • 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 l’API de révisions du Microsoft Store pour répondre par programmation aux révisions de votre application dans le Windows Store. Cette API est particulièrement utile pour les développeurs qui souhaitent répondre en bloc à de nombreux avis sans utiliser l’Espace partenaires. Cette API utilise Azure Active Directory (Azure AD) pour authentifier les appels à partir de votre application ou service.

Les étapes suivantes décrivent le processus de bout en bout :

  1. Vérifiez que vous avez rempli toutes les conditions préalables.
  2. Avant d’appeler une méthode dans l’API de révisions du Microsoft Store, obtenez un jeton d’accès Azure AD. Après avoir obtenu un jeton, vous avez 60 minutes pour utiliser ce jeton dans les appels à l’API de révision du Microsoft Store avant l’expiration du jeton. Une fois le jeton arrivé à expiration, vous pouvez en générer un autre.
  3. Appelez l’API de révisions du Microsoft Store.

Remarque

Outre l’utilisation de l’API de révisions du Microsoft Store pour répondre par programmation aux révisions, vous pouvez également répondre aux révisions à l’aide de l’Espace partenaires.

Étape 1 : Remplir les conditions préalables à l’utilisation de l’API révisions du Microsoft Store

Avant de commencer à écrire du code pour appeler l’API de révisions du Microsoft Store, vérifiez que vous avez rempli les conditions préalables suivantes.

  • Vous (ou votre organisation) devez disposer d’un annuaire Azure AD et de l’autorisation Administrateur général sur l’annuaire. Si vous utilisez déjà Microsoft 365 ou d’autres services professionnels de Microsoft, vous disposez déjà d’un annuaire Azure AD. Sinon, vous pouvez créer un annuaire Azure AD dans l’Espace partenaires sans frais supplémentaires.

  • Vous devez associer une application Azure AD à votre compte Espace partenaires, récupérer l’ID de locataire et l’ID client de l’application et générer une clé. L’application Azure AD représente l’application ou le service à partir duquel vous souhaitez appeler l’API de révisions du Microsoft Store. Il vous faut l’ID tenant, l’ID client et la clé pour obtenir un jeton d’accès Azure AD à transmettre à l’API.

    Remarque

    Vous ne devez effectuer cette tâche qu’une seule fois. Une fois que vous les avez, vous pouvez réutiliser l’ID tenant, l’ID client et la clé chaque fois que vous devez créer un jeton d’accès Azure AD.

Pour associer une application Azure AD à votre compte Espace partenaires et récupérer les valeurs requises :

  1. Dans l’Espace partenaires, associez le compte Espace partenaires de votre organisation à l’annuaire Azure AD de votre organisation.

  2. Ensuite, dans la page Utilisateurs de la section Paramètres du compte de l’Espace partenaires, ajoutez l’application Azure AD qui représente l’application ou le service que vous utiliserez pour répondre aux révisions. Veillez à attribuer à cette application le rôle Gestionnaire. Si l’application n’existe pas encore dans votre annuaire Azure AD, vous pouvez créer une application Azure AD dans l’Espace partenaires.

  3. Revenez à la page Utilisateurs, cliquez sur le nom de votre application Azure AD pour accéder à ses paramètres, puis copiez les valeurs ID tenant et ID client.

  4. Cliquez sur Ajouter une nouvelle clé. Sur l’écran suivant, copiez la valeur Clé. Vous ne pourrez plus accéder à cette information une fois que vous aurez quitté cette page. Pour plus d’informations, consultez Gérer les clés pour une application Azure AD.

Étape 2 : obtenir un jeton d’accès Azure AD

Avant d’appeler l’une des méthodes de l’API de révisions du Microsoft Store, vous devez d’abord obtenir un jeton d’accès Azure AD que vous passez à l’en-tête d’autorisation de chaque méthode dans l’API. 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. Après l'expiration du jeton, vous pouvez le rafraîchir afin de pouvoir continuer à l'utiliser lors d'autres appels à l'API.

Pour obtenir le jeton d’accès, suivez les instructions de la section Appels de service à service à l’aide des informations d’identification du client pour envoyer une requête HTTP POST au point de terminaison https://login.microsoftonline.com/<tenant_id>/oauth2/token. Voici un exemple de requête.

POST https://login.microsoftonline.com/<tenant_id>/oauth2/token HTTP/1.1
Host: login.microsoftonline.com
Content-Type: application/x-www-form-urlencoded; charset=utf-8

grant_type=client_credentials
&client_id=<your_client_id>
&client_secret=<your_client_secret>
&resource=https://manage.devcenter.microsoft.com

Pour la valeur tenant_id dans le POST URI et les paramètres client_id et client_secret, spécifiez l’ID du locataire, l’ID de client et la clé de votre application que vous avez récupérée dans l’Espace partenaires à la section précédente. Pour le paramètre resource, vous devez spécifier https://manage.devcenter.microsoft.com.

Une fois votre jeton d’accès expiré, vous pouvez l’actualiser en suivant les instructions fournies ici.

Étape 3 : Appeler l’API révisions du Microsoft Store

Une fois que vous disposez d’un jeton d’accès Azure AD, vous êtes prêt à appeler l’API de révisions du Microsoft Store. Vous devez transmettre le jeton d’accès à l’en-tête d’autorisation de chaque méthode.

L’API révisions du Microsoft Store contient plusieurs méthodes que vous pouvez utiliser pour déterminer si vous êtes autorisé à répondre à une révision donnée et à envoyer des réponses à une ou plusieurs révisions. Suivez ce processus pour utiliser cette API :

  1. 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 dans l’API d’analyse du Microsoft Store et dans le téléchargement hors connexion du [rapport révisions](/windows/apps/publish/reviews-report).
  2. Appelez les informations de réponse pour la méthode de révisions d’application pour déterminer si vous êtes autorisé à répondre aux révisions. Lorsqu’un client envoie une révision, il peut choisir de ne pas recevoir de réponses à son avis. 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.
  3. Appelez les réponses envoyées à la méthode de révisions d’application pour répondre par programmation aux révisions.