Créer une soumission d’extensionCreate an add-on submission

Utilisez cette méthode dans l’API de soumission de Microsoft Store pour créer une nouvelle soumission de module complémentaire (également appelés dans l’application produit ou produits) pour une application qui est inscrit pour votre compte espace partenaires.Use this method in the Microsoft Store submission API to create a new add-on (also known as in-app product or IAP) submission for an app that is registered to your Partner Center account. Après avoir créé une soumission à l’aide de cette méthode, mettez à jour cette soumission pour apporter les modifications nécessaires aux données de soumission, puis validez la soumission pour permettre son intégration et sa publication.After you successfully create a new submission by using this method, update the submission to make any necessary changes to the submission data, and then commit the submission for ingestion and publishing.

Pour plus d’informations sur la façon dont cette méthode s’inscrit dans le processus de création d’une soumission d’extension à l’aide de l’API de soumission au Microsoft Store, consultez Gérer les soumissions d’extensions.For more information about how this method fits into the process of creating an add-on submission by using the Microsoft Store submission API, see Manage add-on submissions.

Notes

Cette méthode permet de créer une soumission pour une extension existante.This method creates a submission for an existing add-on. Pour créer une extension, utilisez la méthode Créer une extension.To create an add-on, use the Create an add-on method.

PrérequisPrerequisites

Pour utiliser cette méthode, vous devez d’abord effectuer les opérations suivantes :To use this method, you need to first do the following:

  • Si ce n’est pas déjà le cas, remplissez toutes les conditions préalables relatives à l’API de soumission au Microsoft Store.If you have not done so already, complete all the prerequisites for the Microsoft Store submission API.
  • Obtenez un jeton d’accès Azure AD à utiliser dans l’en-tête de requête de cette méthode.Obtain an Azure AD access token to use in the request header for this method. Après avoir obtenu un jeton d’accès, vous avez 60 minutes pour l’utiliser avant expiration.After you obtain an access token, you have 60 minutes to use it before it expires. Une fois le jeton arrivé à expiration, vous pouvez en obtenir un nouveau.After the token expires, you can obtain a new one.
  • Créer un module complémentaire pour l’une de vos applications.Create an add-on for one of your apps. Vous pouvez le faire dans le centre de partenaires, ou vous pouvez le faire à l’aide de la créer un module complémentaire (méthode).You can do this in Partner Center, or you can do this by using the Create an add-on method.

DemandeRequest

Cette méthode présente la syntaxe suivante.This method has the following syntax. 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.See the following sections for usage examples and descriptions of the header and request body.

MéthodeMethod URI de requêteRequest URI
PUBLIERPOST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}/submissions

En-tête de requêteRequest header

HeaderHeader TypeType DescriptionDescription
AuthorizationAuthorization chaînestring Obligatoire.Required. Le jeton d’accès Azure AD sous la forme PORTEUR < jeton>.The Azure AD access token in the form Bearer <token>.

Paramètres de la requêteRequest parameters

NomName TypeType DescriptionDescription
inAppProductIdinAppProductId chaînestring Obligatoire.Required. ID Windows Store de l’extension pour laquelle vous voulez créer une soumission.The Store ID of the add-on for which you want to create a submission. L’ID de Store est disponible dans le centre de partenaires, et il est inclus dans les données de réponse pour les demandes au créer un module complémentaire ou obtenir les détails du module complémentaire.The Store ID is available in Partner Center, and it is included in the response data for requests to Create an add-on or get add-on details.

Corps de la requêteRequest body

Ne fournissez pas de corps de requête pour cette méthode.Do not provide a request body for this method.

Exemple de requêteRequest example

L’exemple suivant montre comment créer une soumission pour une extension.The following example demonstrates how to create a new submission for an add-on.

POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/9NBLGGH4TNMP/submissions HTTP/1.1
Authorization: Bearer <your access token>

RéponseResponse

L’exemple suivant illustre le corps de réponse JSON d’un appel réussi à cette méthode.The following example demonstrates the JSON response body for a successful call to this method. Le corps de la réponse contient des informations sur la nouvelle soumission.The response body contains information about the new submission. Pour plus d’informations sur les valeurs figurant dans le corps de réponse, voir ressource de soumission d’extension.For more details about the values in the response body, see add-on submission resource.

{
  "id": "1152921504621243680",
  "contentType": "EMagazine",
  "keywords": [
    "books"
  ],
  "lifetime": "FiveDays",
  "listings": {
    "en": {
      "description": "English add-on description",
      "icon": {
        "fileName": "add-on-en-us-listing2.png",
        "fileStatus": "Uploaded"
      },
      "title": "Add-on Title (English)"
    },
    "ru": {
      "description": "Russian add-on description",
      "icon": {
        "fileName": "add-on-ru-listing.png",
        "fileStatus": "Uploaded"
      },
      "title": "Add-on Title (Russian)"
    }
  },
  "pricing": {
    "marketSpecificPricings": {
      "RU": "Tier3",
      "US": "Tier4",
    },
    "sales": [
      {
         "name": "Sale1",
         "basePriceId": "Free",
         "startDate": "2016-05-21T18:40:11.7369008Z",
         "endDate": "2016-05-22T18:40:11.7369008Z",
         "marketSpecificPricings": {
            "RU": "NotAvailable"
         }
      }
    ],
    "priceId": "Free",
    "isAdvancedPricingModel": true
  },
  "targetPublishDate": "2016-03-15T05:10:58.047Z",
  "targetPublishMode": "Immediate",
  "tag": "SampleTag",
  "visibility": "Public",
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [
      {
        "code": "None",
        "details": "string"
      }
    ],
    "warnings": [
      {
        "code": "ListingOptOutWarning",
        "details": "You have removed listing language(s): []"
      }
    ],
    "certificationReports": [
      {
      }
    ]
  },
  "fileUploadUrl": "https://productingestionbin1.blob.core.windows.net/ingestion/26920f66-b592-4439-9a9d-fb0f014902ec?sv=2014-02-14&sr=b&sig=usAN0kNFNnYE2tGQBI%2BARQWejX1Guiz7hdFtRhyK%2Bog%3D&se=2016-06-17T20:45:51Z&sp=rwl",
  "friendlyName": "Submission 2"
}

Codes d’erreurError codes

Si la requête ne peut pas aboutir, la réponse contient l’un des codes d’erreur HTTP suivants.If the request cannot be successfully completed, the response will contain one of the following HTTP error codes.

Error codeError code DescriptionDescription
400400 Impossible de créer la soumission, car la requête n’est pas valide.The submission could not be created because the request is invalid.
409409 L’envoi n’a pas pu être créé en raison de l’état actuel de l’application, ou l’application utilise une fonctionnalité de partenaires est actuellement ne pas pris en charge par l’API de soumission de Microsoft Store.The submission could not be created because of the current state of the app, or the app uses a Partner Center feature that is currently not supported by the Microsoft Store submission API.