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.

Notes

Cette méthode crée un module complémentaire sans soumission. Pour créer une soumission pour une extension, voir les méthodes décrites dans l’article Gérer les soumissions d’extensions.

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
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 sous la formeJeton> du porteur<.

Corps de la demande

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

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

Exemple de requête

L’exemple suivant montre comment créer une extension 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 réponse JSON d’un appel réussi à cette méthode. Pour plus d’informations sur les valeurs figurant dans le corps de réponse, consultez ressource d’extension.

{
  "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 aboutir, 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.