Valider une soumission d’extensionCommit an add-on submission

Utilisez cette méthode dans l’API de soumission de Microsoft Store pour valider l’envoi d’un module complémentaire nouveau ou mis à jour (également appelés dans l’application produit ou produits) pour les partenaires.Use this method in the Microsoft Store submission API to commit a new or updated add-on (also known as in-app product or IAP) submission to Partner Center. La validation alertes partenaire centre de maintenance que les données de soumission a été chargées (y compris toutes les icônes associées).The commit action alerts Partner Center that the submission data has been uploaded (including any related icons). En réponse, partenaires valide les modifications de données de soumission pour l’ingestion et la publication.In response, Partner Center commits the changes to the submission data for ingestion and publishing. Une fois l’opération de validation réussit, les modifications apportées à la soumission figurent dans les partenaires.After the commit operation succeeds, the changes to the submission are shown in Partner Center.

Pour plus d’informations sur la façon dont l’opération de validation s’inscrit dans le processus de soumission d’une extension à l’aide de l’API de soumission au Microsoft Store, consultez Gérer les soumissions d’extensions.For more information about how the commit operation fits into the process of submitting an add-on by using the Microsoft Store submission API, see Manage add-on submissions.

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:

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/{submissionId}/commit

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 qui contient la soumission à valider.The Store ID of the add-on that contains the submission you want to commit. 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 obtenir tous les modules complémentaires et créer un module complémentaire.The Store ID is available in Partner Center, and it is included in the response data for requests to Get all add-ons and Create an add-on.
submissionIdsubmissionId chaînestring Obligatoire.Required. ID de la soumission à valider.The ID of the submission you want to commit. Cet ID est disponible dans les données de réponse des requêtes pour créer une soumission d'extension.This ID is available in the response data for requests to create an add-on submission. Pour la soumission qui a été créée dans le centre de partenaires, cet ID est également disponible dans l’URL de la page d’envoi dans l’espace partenaires.For a submission that was created in Partner Center, this ID is also available in the URL for the submission page in Partner Center.

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 valider une soumission d’extension.The following example demonstrates how to commit an add-on submission.

POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/9NBLGGH4TNMP/submissions/1152921504621230023/commit 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. Pour plus d’informations sur les valeurs figurant dans le corps de réponse, voir les sections suivantes.For more details about the values in the response body, see the following sections.

{
  "status": "CommitStarted"
}

Corps de la réponseResponse body

ValueValue TypeType DescriptionDescription
statusstatus chaînestring État de la soumission.The status of the submission. Les valeurs possibles sont les suivantes :This can be one of the following values:
  • AucuneNone
  • CanceledCanceled
  • PendingCommitPendingCommit
  • CommitStartedCommitStarted
  • CommitFailedCommitFailed
  • PendingPublicationPendingPublication
  • PublicationPublishing
  • PublishedPublished
  • PublishFailedPublishFailed
  • PreProcessingPreProcessing
  • PreProcessingFailedPreProcessingFailed
  • CertificationCertification
  • CertificationFailedCertificationFailed
  • ReleaseRelease
  • ReleaseFailedReleaseFailed

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 Les paramètres de la requête ne sont pas valides.The request parameters are invalid.
404404 La soumission spécifiée est introuvable.The specified submission could not be found.
409409 La soumission spécifiée a été trouvée, mais il ne peut pas être validée dans son état actuel, ou le module complémentaire utilise une fonctionnalité de partenaires est actuellement ne pas pris en charge par l’API de soumission de Microsoft Store.The specified submission was found but it could not be committed in its current state, or the add-on uses a Partner Center feature that is currently not supported by the Microsoft Store submission API.