Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Utilisez l’API de soumission du Microsoft Store pour interroger et créer de manière programmatique des soumissions pour les applications, les modules complémentaires et les mises en vol de package pour le compte Espace partenaires de votre organisation. Cette API est utile si votre compte gère de nombreuses applications ou modules complémentaires, et que vous souhaitez automatiser et optimiser le processus de soumission pour ces ressources. 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 de l’utilisation de l’API de soumission du Microsoft Store :
- Vérifiez que vous avez rempli toutes les conditions préalables .
- Avant d’appeler une méthode dans l’API de soumission au Microsoft Store, obtenir 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 soumission du Microsoft Store avant l’expiration du jeton. Une fois le jeton expiré, vous pouvez générer un nouveau jeton.
- Appeler l’API de soumission du Microsoft Store.
Important
Si vous utilisez cette API pour créer une soumission pour une application, un vol de package ou un module complémentaire, assurez-vous de n'apporter d'autres modifications à la soumission qu'en utilisant l'API, plutôt que dans le Portail Partenaires. Si vous utilisez l’Espace partenaires pour modifier une soumission que vous avez créée à l’origine à l’aide de l’API, vous ne pourrez plus modifier ou valider cette soumission à l’aide de l’API. Dans certains cas, la soumission peut être laissée dans un état d’erreur où elle ne peut pas continuer dans le processus de soumission. Si cela se produit, vous devez supprimer la soumission et créer une nouvelle soumission.
Important
Vous ne pouvez pas utiliser cette API pour publier des soumissions pour les achats en volume via le Microsoft Store pour les entreprises et le Microsoft Store pour l'éducation ou pour publier des soumissions pour les applications LOB directement aux entreprises. Pour ces deux scénarios, vous devez publier la soumission dans le Centre de partenaires.
Remarque
Cette API ne peut pas être utilisée avec des applications ou des modules complémentaires qui utilisent des mises à jour d’application obligatoires et des modules complémentaires consommables gérés par le Store. Si vous utilisez l’API de soumission du Microsoft Store avec une application ou un module complémentaire qui utilise l’une de ces fonctionnalités, l’API retourne un code d’erreur 409. Dans ce cas, vous devez utiliser l’Espace partenaires pour gérer les soumissions de l’application ou du module complémentaire.
Remarque
Vous ne pouvez pas utiliser cette API avec des applications ou des modules complémentaires qui se trouvent sur la tarification version 2. Un produit se trouve sur la version 2 du prix s’il existe un bouton Vérifier le prix par marché dans la section Tarification de la page Tarification et disponibilité . Si vous utilisez l’API de soumission du Microsoft Store avec une application ou un module complémentaire qui se trouve sur la tarification version 2, l’API retourne un niveau inconnu pour la partie tarifaire. Vous pouvez continuer à utiliser cette API pour mettre à jour des modules autres que la tarification et la disponibilité.
Étape 1 : Prérequis complets pour l’utilisation de l’API de soumission du Microsoft Store
Avant de commencer à écrire du code pour appeler l’API de soumission au 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 vous devez disposer d''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 Azure AD. Sinon, vous pouvez créer un Azure AD via l’espace Partenaires sans frais supplémentaires.
Vous devez associer une application Azure AD à votre compte Espace partenaires et obtenir votre ID de locataire, votre ID client et votre clé. Vous avez besoin de ces valeurs pour obtenir un jeton d’accès Azure AD, que vous utiliserez dans les appels à l’API de soumission du Microsoft Store.
Préparez votre application à utiliser avec l’API de soumission au Microsoft Store :
Si votre application n’existe pas encore dans l’Espace partenaires, vous devez créer votre application en réservant son nom dans l’Espace partenaires. Vous ne pouvez pas utiliser l’API de soumission du Microsoft Store pour créer une application dans l’Espace partenaires ; vous devez travailler dans l’Espace partenaires pour le créer, puis après cela, vous pouvez utiliser l’API pour accéder à l’application et créer par programmation des soumissions pour celle-ci. Toutefois, vous pouvez utiliser l'API pour créer des modules complémentaires et des lots de tests par programmation avant de soumettre ces derniers.
Avant de pouvoir créer une soumission pour une application donnée à l’aide de cette API, vous devez d’abord créer une soumission pour l’application dans l’Espace partenaires, y compris répondre au questionnaire sur les classements d’âge . Une fois cette opération effectuée, vous pourrez créer par programmation de nouvelles soumissions pour cette application à l’aide de l’API. Vous n’avez pas besoin de créer une soumission d’extension ni de soumission pour version de package avant d’utiliser l’API pour ces types de soumission.
Si vous créez ou mettez à jour une soumission d’application et que vous devez inclure un package d’application, préparer le package d’application.
Si vous créez ou mettez à jour une soumission d'application et que vous devez inclure des captures d'écran ou des images pour la liste du Store, préparez les captures d'écran et les images de l'application.
Si vous créez ou mettez à jour une soumission d'un module complémentaire et que vous devez inclure une icône, préparez l’icône.
Comment associer une application Azure AD à votre compte Espace partenaires
Avant de pouvoir utiliser l’API de soumission du Microsoft Store, 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 soumission du Microsoft Store. Vous avez besoin de l’ID de locataire, de l’ID client et de la clé pour obtenir un jeton d’accès Azure AD que vous transmettez à l’API.
Remarque
Vous n’avez besoin d’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 Azure AD.
Dans l’Espace Partenaires, associez votre compte Partner Center à l'Annuaire Azure AD de votre organisation.
Ensuite, à partir de la page Utilisateurs dans 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 accéder aux soumissions de votre compte Espace partenaires. Veillez à attribuer à cette application le rôle Manager. Si l’application n’existe pas encore dans votre annuaire Azure AD, vous pouvez créer une application Azure AD dans l’Espace partenaires.
Retournez sur la page Utilisateurs, cliquez sur le nom de votre application Azure AD pour accéder aux paramètres de l’application, puis copiez les valeurs de l'ID de locataire et de l'ID client .
Cliquez sur Ajouter une nouvelle clé. Sur l'écran suivant, recopiez la valeur de la clé . Vous ne pourrez plus accéder à ces informations après avoir 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 soumission au 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 de 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. Une fois le jeton expiré, vous pouvez actualiser le jeton pour continuer à l’utiliser dans d’autres appels à l’API.
Pour obtenir le jeton d’accès, suivez les instructions de Service aux appels de 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 l’URI POST et les paramètres client_id et client_secret, spécifiez l’ID de locataire, l’ID client et la clé de votre application que vous avez récupérées à partir de l’Espace partenaires dans la section précédente. Pour le paramètre de ressource
Une fois votre jeton d’accès expiré, vous pouvez récupérer un nouvel appel en effectuant à nouveau le même appel HTTP.
Pour obtenir des exemples illustrant comment obtenir un jeton d’accès à l’aide du code C#, Java ou Python, consultez l’API de soumission du Microsoft Store exemples de code.
Étape 3 : Utiliser l’API de soumission du Microsoft Store
Une fois que vous avez un jeton d’accès Azure AD, vous pouvez appeler des méthodes dans l’API de soumission du Microsoft Store. L’API inclut de nombreuses méthodes regroupées dans des scénarios pour les applications, les modules complémentaires et les vols de package. Pour créer ou mettre à jour des soumissions, vous appelez généralement plusieurs méthodes dans l’API de soumission du Microsoft Store dans un ordre spécifique. Pour plus d’informations sur chaque scénario et la syntaxe de chaque méthode, consultez les articles du tableau suivant.
Remarque
Après avoir obtenu un jeton d’accès, vous avez 60 minutes pour appeler des méthodes dans l’API de soumission du Microsoft Store avant l’expiration du jeton.
Scénario | Descriptif |
---|---|
Applications | Récupérez des données pour toutes les applications inscrites dans votre compte Espace partenaires et créez des soumissions pour les applications. Pour plus d’informations sur ces méthodes, consultez les articles suivants : |
Modules complémentaires | Obtenez, créez ou supprimez des modules complémentaires pour vos applications, puis obtenez, créez ou supprimez des soumissions pour les modules complémentaires. Pour plus d’informations sur ces méthodes, consultez les articles suivants :
|
Forfaits de vols | Obtenez, créez ou supprimez des vols de package pour vos applications, puis obtenez, créez ou supprimez des soumissions pour les vols de package. Pour plus d’informations sur ces méthodes, consultez les articles suivants : |
Exemples de code
Les articles suivants fournissent des exemples de code détaillés qui montrent comment utiliser l’API de soumission du Microsoft Store dans plusieurs langages de programmation différents :
- exemple C# : soumissions d’applications, de modules complémentaires et de vols d'essai
- exemple C# : soumission d’applications avec des options de jeu et des bandes-annonces
- exemple Java : soumissions pour les applications, les extensions et les vols
- exemple Java : soumission d’applications avec des options de jeu et des bandes-annonces
- exemple Python : soumissions pour les applications, les modules complémentaires et les versions pilotes
- exemple Python : soumission d’applications avec des options de jeu et des bandes-annonces
Module StoreBroker PowerShell
En guise d’alternative à l’appel direct de l’API de soumission du Microsoft Store, nous fournissons également un module PowerShell open source qui implémente une interface de ligne de commande au-dessus de l’API. Ce module est appelé StoreBroker. Vous pouvez utiliser ce module pour gérer vos soumissions d'application, de vol et de module complémentaire à partir de la ligne de commande au lieu d’appeler directement l'API de soumission du Microsoft Store, ou vous pouvez simplement parcourir la source pour voir d'autres exemples de l'utilisation de cette API. Le module StoreBroker est utilisé activement au sein de Microsoft comme principale façon dont de nombreuses applications internes sont soumises au Windows Store.
Pour plus d’informations, consultez notre page StoreBroker sur GitHub.
Résolution des problèmes
Problème | Résolution |
---|---|
Après avoir appelé l’API de soumission du Microsoft Store à partir de PowerShell, les données de réponse de l’API sont endommagées si vous la convertissez à partir d’un format JSON en objet PowerShell à l’aide de l’applet de commande ConvertFrom-Json |
Par défaut, le paramètre -Depth de l’applet de commande ConvertTo-Json est défini sur 2 niveaux d’objets, ce qui est trop peu profond pour la plupart des objets JSON retournés par l’API de soumission au Microsoft Store. Lorsque vous appelez l’applet de commande |
Aide supplémentaire
Si vous avez des questions sur l’API de soumission du Microsoft Store ou si vous avez besoin d’aide pour gérer vos soumissions avec cette API, utilisez les ressources suivantes :
- Posez vos questions sur nos forums .
- Visitez notre page de support et demandez l’une des options de support assisté pour l’Espace partenaires. Si vous êtes invité à choisir un type de problème et une catégorie, choisissez soumission et certification d’application et Envoi d’une application, respectivement.