Partager via

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 du 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 modules complémentaires. Pour créer des soumissions pour les modules complémentaires, consultez les méthodes de gestion des soumissions de modules complémentaires.

Method URI Description
GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts Obtenir tous les modules complémentaires pour vos applications
GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId} Obtenir un module complémentaire spécifique
POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts Créer une extension
DELETE https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId} Supprimer un module complémentaire

Prérequis

Si vous ne l’avez pas déjà fait, remplissez toutes les conditions préalables pour l’API de soumission du 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 de module complémentaire

Cette ressource décrit un module complémentaire.

{
  "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 ce module complémentaire est associé. Un seul élément est pris en charge dans ce tableau.
id string ID store du module complémentaire. Cette valeur est fournie par le Windows Store. Un exemple d’ID store est 9NBLGGH4TNMP.
productId string ID de produit du module complémentaire. Il s’agit de l’ID fourni par le développeur lors de la création du module complémentaire. Pour plus d’informations, consultez Définir votre type de produit et votre ID de produit.
productType string Type de produit du module complémentaire. 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 pour le module complémentaire.
pendingInAppProductSubmission object Ressource de soumission qui fournit des informations sur la soumission en attente actuelle pour le module complémentaire.

Ressource d'application

Cette ressource déscrit l’application à laquelle un module complémentaire est associé. 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 store, consultez Afficher les détails de l’identité de l’application.
  • resourceLocation. Chemin d’accès relatif que vous pouvez ajouter à l’URI de demande de base https://manage.devcenter.microsoft.com/v1.0/my/ pour récupérer les données complètes de l’application.
totalCount int Nombre d’objets d’application dans le tableau d’applications du corps de la réponse.

Ressource de soumission

Cette ressource fournit des informations sur une soumission pour un module complémentaire. 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 L’ID de la soumission.
resourceLocation string Chemin d’accès relatif que vous pouvez ajouter à l’URI de demande de base https://manage.devcenter.microsoft.com/v1.0/my/ pour récupérer les données complètes de la soumission.