Obtenir toutes les extensions
Utilisez cette méthode dans l’API de soumission du Microsoft Store pour récupérer les données de toutes les extensions pour toutes les applications inscrites à votre compte espace partenaires.
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 tous les prérequis pour l’API de soumission du Microsoft Store.
- Obtenez un jeton d’accès Azure AD à utiliser dans l’en-tête de requête de 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 arrivé à expiration, vous pouvez en obtenir un nouveau.
Requête
Cette méthode présente la syntaxe suivante. Consultez les sections suivantes pour obtenir des exemples d’utilisation et une description de l’en-tête et du corps de la requête.
Méthode | URI de demande |
---|---|
GET | https://manage.devcenter.microsoft.com/v1.0/my/inappproducts |
En-tête de requête
En-tête | Type | Description |
---|---|---|
Autorisation | string | Obligatoire. Jeton d’accès Azure AD sous la formeJeton> du porteur<. |
Paramètres de la demande
Tous les paramètres de la requête sont facultatifs pour cette méthode. Si vous appelez cette méthode sans paramètre, la réponse contient les données de toutes les extensions pour toutes les applications inscrites dans votre compte.
Paramètre | Type | Description | Obligatoire |
---|---|---|---|
top | int | Nombre d’éléments à retourner dans la requête (autrement dit, nombre d’extensions à retourner). Si votre compte comporte plus d’extensions que la valeur que vous spécifiez dans la requête, le corps de la réponse comprend un chemin d’URI relatif que vous pouvez ajouter à l’URI de la méthode pour solliciter la page suivante de données. | Non |
skip | int | Nombre d’éléments à ignorer dans la requête avant de retourner les éléments restants. Utilisez ce paramètre pour parcourir des ensembles de données. Par exemple, top=10 et skip=0 permettent de récupérer les éléments 1 à 10, top=10 et skip=10 permettent de récupérer les éléments 11 à 20, et ainsi de suite. | Non |
Corps de la demande
Ne fournissez pas de corps de requête pour cette méthode.
Exemples de demande
L’exemple suivant montre comment récupérer toutes les données d’extension de toutes les applications inscrites dans votre compte.
GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts HTTP/1.1
Authorization: Bearer <your access token>
L’exemple suivant montre comment récupérer les 10 premières extensions uniquement.
GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts?top=10 HTTP/1.1
Authorization: Bearer <your access token>
response
L’exemple suivant montre le corps de réponse JSON renvoyé par une requête réussie sur les 5 premières extensions inscrites dans un compte de développeur qui en possède 1072 au total. Pour des raisons de concision, cet exemple affiche uniquement les données des deux premières extensions retournées par la requête. Pour plus d’informations sur les valeurs figurant dans le corps de réponse, voir la section suivante.
{
"@nextLink": "inappproducts/?skip=5&top=5",
"value": [
{
"applications": {
"value": [
{
"id": "9NBLGGH4R315",
"resourceLocation": "applications/9NBLGGH4R315"
}
],
"totalCount": 1
},
"id": "9NBLGGH4TNMP",
"productId": "a8b8310b-fa8d-4da0-aca0-577ef6dce4dd",
"productType": "Consumable",
"pendingInAppProductSubmission": {
"id": "1152921504621243619",
"resourceLocation": "inappproducts/9NBLGGH4TNMP/submissions/1152921504621243619"
},
"lastPublishedInAppProductSubmission": {
"id": "1152921504621243705",
"resourceLocation": "inappproducts/9NBLGGH4TNMP/submissions/1152921504621243705"
}
},
{
"applications": {
"value": [
{
"id": "9NBLGGH4R315",
"resourceLocation": "applications/9NBLGGH4R315"
}
],
"totalCount": 1
},
"id": "9NBLGGH4TNMN",
"productId": "6a3c9788-a350-448a-bd32-16160a13018a",
"productType": "Consumable",
"pendingInAppProductSubmission": {
"id": "1152921504621243538",
"resourceLocation": "inappproducts/9NBLGGH4TNMN/submissions/1152921504621243538"
},
"lastPublishedInAppProductSubmission": {
"id": "1152921504621243106",
"resourceLocation": "inappproducts/9NBLGGH4TNMN/submissions/1152921504621243106"
}
},
// Other add-ons omitted for brevity...
],
"totalCount": 1072
}
Response body
Valeur | Type | Description |
---|---|---|
@nextLink | string | S’il existe des pages supplémentaires de données, cette chaîne contient un chemin relatif que vous pouvez ajouter à l’URI de requête https://manage.devcenter.microsoft.com/v1.0/my/ de base pour solliciter la page suivante de données. Par exemple, si le paramètre supérieur du corps de la demande initiale est défini sur 10, mais que 100 modules complémentaires sont inscrits dans votre compte, le corps de inappproducts?skip=10&top=10 la réponse inclut la @nextLink valeur , ce qui indique que vous pouvez appeler https://manage.devcenter.microsoft.com/v1.0/my/inappproducts?skip=10&top=10 pour demander les 10 modules complémentaires suivants. |
value | tableau | Tableau contenant des objets qui fournissent des informations sur chaque extension. Pour plus d’informations, voir ressource d’extension. |
totalCount | int | Nombre d’objets d’application dans le tableau value du corps de réponse. |
Codes d’erreur
Si la requête ne peut pas aboutir, la réponse contient l’un des codes d’erreur HTTP suivants.
Code d'erreur | Description |
---|---|
404 | Aucune extension n’a été trouvée. |
409 | Les applications ou modules complémentaires utilisent des fonctionnalités de l’Espace partenaires qui ne sont actuellement pas prises en charge par l’API de soumission au Microsoft Store. |
Rubriques connexes
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour