Partager via

Intégration de l’API de soumission de l’Espace partenaires

  • Article

Utilisez l’API de soumission de l’Espace partenaires pour interroger, soumettre et publier programmatiquement des offres commerciales sur la Place de marché. Cette API est utile si votre compte gère de nombreuses offres et que vous souhaitez automatiser et optimiser le processus de soumission de ces offres.

Prérequis de l’API

L’API de soumission de l’Espace partenaires nécessite quelques ressources programmatiques :

  • une application Microsoft Entra
  • un jeton d’accès Microsoft Entra

Étape 1 : Prérequis complets pour l’utilisation de l’API de soumission de l’Espace partenaires

Avant de commencer à écrire du code pour appeler l’API de soumission de l’Espace partenaires, vérifiez que vous avez rempli les conditions préalables suivantes.

  • Vous (ou votre organisation) devez disposer d’un annuaire Microsoft Entra et vous devez disposer de l’autorisation d’administrateur général pour l’annuaire. Si vous utilisez déjà Microsoft 365 ou d’autres services professionnels de Microsoft, vous disposez déjà d’un annuaire Microsoft Entra. Sinon, vous pouvez créer un NOUVEL ID Microsoft Entra dans l’Espace partenaires sans frais supplémentaires.
  • Vous devez associer une application Microsoft Entra à votre compte Espace partenaires et obtenir votre ID de locataire, votre ID client et votre clé. Vous en avez besoin pour obtenir le jeton d’accès Microsoft Entra que vous utiliserez dans les appels à l’API de soumission du Microsoft Store.

Associer une application Microsoft Entra à votre compte Espace partenaires

Pour utiliser l’API de soumission de l’Espace partenaires, vous devez associer une application Microsoft Entra à votre compte Espace partenaires, récupérer l’ID client et l’ID client de l’application et générer une clé. L’application Microsoft Entra représente l’application ou le service à partir duquel vous souhaitez appeler l’API de soumission de l’Espace partenaires. Vous avez besoin de l’ID de locataire, de l’ID client et de la clé pour obtenir un jeton d’accès Microsoft Entra à transmettre à l’API.

Remarque

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

  1. Dans l’Espace partenaires, associez le compte espace partenaires de votre organisation à l’annuaire Microsoft Entra de votre organisation.

  2. Dans la page Utilisateurs de la section Paramètres du compte de l’Espace partenaires, ajoutez l’application Microsoft Entra qui représente l’application ou le service que vous utiliserez pour accéder aux soumissions de votre compte Espace partenaires. Veillez à attribuer à cette application le rôle Gestionnaire. Si l’application n’existe pas encore dans votre annuaire Microsoft Entra, créez une application Microsoft Entra dans l’Espace partenaires.

  3. Revenez à la page Utilisateurs, sélectionnez le nom de votre application Microsoft Entra pour accéder aux paramètres de l’application, puis copiez l’ID de locataire et les valeurs d’ID client.

  4. Sélectionnez Ajouter une nouvelle clé. Sur l’écran suivant, copiez la valeur de la 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 d’une application Microsoft Entra.

Étape 2 : Obtenir un jeton d’accès Microsoft Entra

Avant d’appeler l’une des méthodes de l’API de soumission de l’Espace partenaires, vous devez d’abord obtenir un jeton d’accès Microsoft Entra pour passer à l’en-tête d’autorisation de chaque méthode de l’API. Un jeton d’accès expire 60 minutes après son émission. Vous pouvez ensuite l’actualiser pour pouvoir l’utiliser dans les prochains 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://api.partner.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 de ressource, vous devez spécifier https://api.partner.microsoft.com.

Étape 3 : Utiliser l’API de soumission de l’Espace partenaires

Une fois que vous avez un jeton d’accès Microsoft Entra, appelez des méthodes dans l’API de soumission de l’Espace partenaires. Pour créer ou mettre à jour des soumissions, on appelle généralement plusieurs méthodes de l’API de soumission de l’Espace partenaires dans un ordre spécifique. Pour plus d’informations sur les différents scénarios et la syntaxe de chaque méthode, consultez l’API d’ingestion dans Swagger.

Contenu connexe

  • Commencez à utiliser l’API de soumission de l’Espace partenaires comme indiqué ci-dessus