Valider une soumission d’applicationCommit an app submission

Utilisez cette méthode dans l’API Microsoft Store soumission pour valider une soumission d’application nouvelle ou mise à jour dans l’espace partenaires.Use this method in the Microsoft Store submission API to commit a new or updated app submission to Partner Center. L’action de validation alerte le Centre des partenaires que les données d’envoi ont été téléchargées (y compris les packages et les images associés).The commit action alerts Partner Center that the submission data has been uploaded (including any related packages and images). En réponse, l’espace partenaires valide les modifications apportées aux données d’envoi 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éussie, les modifications apportées à l’envoi sont affichées dans l’espace 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’intègre au processus d’envoi d’une application à l’aide de l’API de soumission Microsoft Store, consultez gérer les envois d’applications.For more information about how the commit operation fits into the process of submitting an app by using the Microsoft Store submission API, see Manage app 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:

RequêteRequest

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 demandeRequest URI
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/commit

En-tête de requêteRequest header

En-têteHeader TypeType DescriptionDescription
AutorisationAuthorization stringstring Obligatoire.Required. Jeton d’accès Azure AD sous la forme Bearer <jeton>.The Azure AD access token in the form Bearer <token>.

Paramètres de la demandeRequest parameters

NomName TypeType DescriptionDescription
applicationIdapplicationId stringstring Obligatoire.Required. L’ID Windows Store de l’application qui contient la soumission à valider.The Store ID of the app that contains the submission you want to commit. Pour plus d’informations sur l’ID Windows Store, voir Visualiser les informations d’identité des applications.For more information about the Store ID, see View app identity details.
submissionIdsubmissionId stringstring 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 pour les demandes de création d’une soumission d’application.This ID is available in the response data for requests to create an app submission. Pour une soumission qui a été créée dans l’espace partenaires, cet ID est également disponible dans l’URL de la page de soumission 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 demandeRequest 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 de requête.The following example demonstrates how to commit an app submission.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/submissions/1152921504621243610/commit HTTP/1.1
Authorization: Bearer <your access token>

responseResponse

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"
}

Response bodyResponse body

ValeurValue TypeType DescriptionDescription
statusstatus stringstring État de la soumission.The status of the submission. Il peut s’agir de l’une des valeurs suivantes :This can be one of the following values:
  • AucuneNone
  • Opération annuléeCanceled
  • PendingCommitPendingCommit
  • CommitStartedCommitStarted
  • CommitFailedCommitFailed
  • PendingPublicationPendingPublication
  • PublicationPublishing
  • PubliéPublished
  • PublishFailedPublishFailed
  • PreProcessingPreProcessing
  • PreProcessingFailedPreProcessingFailed
  • CertificationCertification
  • CertificationFailedCertificationFailed
  • LibérerRelease
  • 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.

Code d'erreurError 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 L’envoi spécifié a été trouvé, mais il n’a pas pu être validé dans son état actuel, ou l’application utilise une fonctionnalité d’espace partenaires qui n’est actuellement pas prise en charge par l’API de soumission Microsoft Store.The specified submission was found but it could not be committed in its current state, or the app uses a Partner Center feature that is currently not supported by the Microsoft Store submission API.