Partager via

Créer une extension

  • Article

Utilisez cette méthode dans l’API de soumission du Microsoft Store pour créer un module complémentaire (également appelé produit in-app ou IAP) pour une application inscrite dans votre compte Espace partenaires.

Remarque

Cette méthode crée un module complémentaire sans soumission. Pour créer une soumission pour un module complémentaire, consultez les méthodes de gestion des soumissions de modules complémentaires.

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 toutes les conditions préalables pour l’API de soumission au Microsoft Store.
  • Obtenir 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 demande
POST 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 au format porteur<jeton>.

Corps de la demande

Le corps de la requête a les paramètres suivants.

Paramètre Type Description Obligatoire
applicationIds tableau Tableau qui contient l’ID Store de l’application à laquelle ce module complémentaire est associé. Un seul élément est pris en charge dans ce tableau. Oui
productId string ID de produit du module complémentaire. Il s’agit d’un identificateur qui peut être utilisé dans le code pour faire référence au module complémentaire. Pour plus d’informations, consultez Définir votre type de produit et votre ID de produit. Oui
productType string Type de produit du module complémentaire. Les valeurs suivantes sont prises en charge : Durable et Consommable. Oui

Exemple de requête

L’exemple suivant montre comment créer un module complémentaire consommable pour une application.

POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1Q...
Content-Type: application/json
{
    "applicationIds": [  "9NBLGGH4R315"  ],
    "productId": "my-new-add-on",
    "productType": "Consumable",
}

Response

L’exemple suivant illustre le corps de la réponse JSON pour un appel réussi à cette méthode. Pour plus d’informations sur les valeurs dans le corps de la réponse, consultez la ressource de module complémentaire.

{
  "applications": {
    "value": [
      {
        "id": "9NBLGGH4R315",
        "resourceLocation": "applications/9NBLGGH4R315"
      }
    ],
    "totalCount": 1
  },
  "id": "9NBLGGH4TNMP",
  "productId": "my-new-add-on",
  "productType": "Consumable",
}

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 Description
400 La requête n’est pas valide.
409 Le module complémentaire n’a pas pu être créé en raison de son état actuel, ou le module complémentaire utilise une fonctionnalité de l’Espace partenaires qui n’est actuellement pas prise en charge par l’API de soumission du Microsoft Store.