Gérer les extensions

  • Article

Utilisez les méthodes suivantes dans l’API de soumission du Microsoft Store pour gérer les modules complémentaires pour vos applications. Pour une présentation de l’API de soumission au Microsoft Store, y compris les conditions préalables à l’utilisation de l’API, consultez Créer et gérer des soumissions à l’aide des services du Microsoft Store.

Ces méthodes peuvent uniquement être utilisées pour obtenir, créer ou supprimer des extensions. Pour créer des soumissions pour des extensions, voir les méthodes indiquées dans Gérer les soumissions d’extensions.

Méthode URI Description
GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts Obtient toutes les extensions pour vos applications
GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId} Obtient une extension spécifique
POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts Créer une extension
Suppression https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId} Supprime une extension

Prérequis

Si vous ne l’avez pas déjà fait, remplissez tous les prérequis pour l’API de soumission au Microsoft Store avant d’essayer d’utiliser l’une de ces méthodes.

Ressources de données

Les méthodes d’API de soumission du Microsoft Store pour la gestion des modules complémentaires utilisent les ressources de données JSON suivantes.

Ressource d’extension

Cette ressource décrit une extension.

{
  "applications": {
    "value": [
      {
        "id": "9NBLGGH4R315",
        "resourceLocation": "applications/9NBLGGH4R315"
      }
    ],
    "totalCount": 1
  },
  "id": "9NBLGGH4TNMP",
  "productId": "TestAddOn",
  "productType": "Durable",
  "pendingInAppProductSubmission": {
    "id": "1152921504621243619",
    "resourceLocation": "inappproducts/9NBLGGH4TNMP/submissions/1152921504621243619"
  },
  "lastPublishedInAppProductSubmission": {
    "id": "1152921504621243705",
    "resourceLocation": "inappproducts/9NBLGGH4TNMP/submissions/1152921504621243705"
  }
}

Cette ressource a les valeurs suivantes.

Valeur Type Description
applications tableau Tableau qui contient une ressource d’application qui représente l’application à laquelle cette extension est associée. Un seul élément est pris en charge dans ce tableau.
id string ID Windows Store de l’extension. Cette valeur est fournie par le Windows Store. Exemple d’ID Windows Store : 9NBLGGH4TNMP.
productId string ID de produit de l’extension. Il s’agit de l’ID fourni par le développeur au moment de la création de l’extension. Pour plus d’informations, consultez Définir le type et l’ID de votre produit.
productType string Type de produit de l’extension. Les valeurs suivantes sont prises en charge : Durable et Consommable.
lastPublishedInAppProductSubmission object Ressource de soumission qui fournit des informations sur la dernière soumission publiée de l’extension.
pendingInAppProductSubmission object Ressource de soumission qui fournit des informations sur la soumission actuellement en attente pour l’extension.

Ressource d'application

Cette ressource décrit l’application à laquelle une extension est associée. L’exemple suivant illustre le format de cette ressource.

{
  "applications": {
    "value": [
      {
        "id": "9NBLGGH4R315",
        "resourceLocation": "applications/9NBLGGH4R315"
      }
    ],
    "totalCount": 1
  },
}

Cette ressource a les valeurs suivantes.

Valeur Type Description
value object Objet qui contient les valeurs suivantes :
  • id. ID store de l’application. Pour plus d’informations sur l’ID Windows Store, voir Visualiser les informations d’identité des applications.
  • resourceLocation. Chemin relatif à ajouter à l’URI de requête https://manage.devcenter.microsoft.com/v1.0/my/ de base pour récupérer les données complètes de l’application.
totalCount int Nombre d’objets d’application dans le tableau applications du corps de la réponse.

Ressource de soumission

Cette ressource fournit des informations sur une soumission pour une extension. L’exemple suivant illustre le format de cette ressource.

{
  "pendingInAppProductSubmission": {
    "id": "1152921504621243619",
    "resourceLocation": "inappproducts/9NBLGGH4TNMP/submissions/1152921504621243619"
  },
}

Cette ressource a les valeurs suivantes.

Valeur Type Description
id string ID de la soumission.
resourceLocation string Chemin relatif à ajouter à l’URI de requête https://manage.devcenter.microsoft.com/v1.0/my/ de base pour récupérer les données complètes de la soumission.