Obtenir toutes les extensions

Utilisez cette méthode dans l’API de soumission du Microsoft Store pour récupérer des données pour tous les modules complémentaires pour toutes les applications inscrites dans votre compte Espace partenaires.

Conditions préalables

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 de soumission 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.

Requête

Cette méthode a la syntaxe suivante. Consultez les sections suivantes pour obtenir des exemples d’utilisation et des descriptions du corps de l’en-tête et de la demande.

Méthode URI de la requête
OBTENIR https://manage.devcenter.microsoft.com/v1.0/my/inappproducts

En-tête de requête

En-tête de page Catégorie Descriptif
Autorisation ficelle Obligatoire. Le jeton d’accès Azure AD sous la forme Bearer<token>.

Paramètres de la demande

Tous les paramètres de requête sont facultatifs pour cette méthode. Si vous appelez cette méthode sans paramètres, la réponse contient des données pour tous les modules complémentaires pour toutes les applications inscrites dans votre compte.

Paramètre Catégorie Descriptif Obligatoire
Haut de page Int Nombre d’éléments à retourner dans la demande (autrement dit, le nombre de modules complémentaires à renvoyer). Si votre compte a plus de modules complémentaires que la valeur que vous spécifiez dans la requête, le corps de la réponse inclut un chemin d’URI relatif que vous pouvez ajouter à l’URI de méthode pour demander la page suivante des données. Non
passer Int Nombre d’éléments à contourner dans la requête avant de renvoyer les éléments restants. Utilisez ce paramètre pour parcourir des jeux de données. Par exemple, top=10 et skip=0 récupère les éléments 1 à 10, top=10 et skip=10 récupère les éléments 11 à 20, et ainsi de suite. Non

Corps de la requête

Ne fournissez pas de corps de requête pour cette méthode.

Demander des exemples

L’exemple suivant montre comment récupérer toutes les données d’extension pour 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 premiers modules complémentaires uniquement.

GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts?top=10 HTTP/1.1
Authorization: Bearer <your access token>

Réponse

L’exemple suivant illustre le corps de réponse JSON retourné par une demande réussie pour les 5 premiers modules complémentaires inscrits dans un compte de développeur avec 1072 modules complémentaires totaux. Par souci de concision, cet exemple affiche uniquement les données des deux premiers modules complémentaires retournés par la requête. Pour plus d’informations sur les valeurs dans le corps de la réponse, consultez 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
}

Corps de réponse

Valeur Catégorie Descriptif
@nextLink ficelle S’il existe des pages de données supplémentaires, cette chaîne contient un chemin d’accès relatif que vous pouvez ajouter à l’URI de requête de base https://manage.devcenter.microsoft.com/v1.0/my/ pour demander la page suivante des données. Par exemple, si le paramètre premier du corps de la requête initiale est défini sur 10, mais qu’il existe 100 modules complémentaires inscrits sur votre compte, le corps de la réponse inclut une valeur @nextLink de inappproducts?skip=10&top=10, 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.
valeur tableau Tableau qui contient des objets qui fournissent des informations sur chaque module complémentaire. Pour plus d'informations, consultez la ressource de module complémentaire.
nombre total Int Le nombre d'objets d'application dans le tableau de valeur du corps de la réponse.

Codes d’erreur

Si la requête ne peut pas être terminée, la réponse contient l’un des codes d’erreur HTTP suivants.

Code d’erreur Descriptif
404 Aucun module complémentaire n’a été trouvé.
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 du Microsoft Store.
  • Last updated on