Commit an add-on submission (Confirmar un envío de complemento)Commit an add-on submission

Utilice este método en la API de envío de Microsoft Store para confirmar el envío de un complemento nuevo o actualizado (también conocido como aplicación producto o IAP) al centro de partners.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. El centro de partners alertas de confirmación acción se que se ha cargado los datos de envío (incluidos los iconos relacionados).The commit action alerts Partner Center that the submission data has been uploaded (including any related icons). En respuesta, el centro de partners confirma los cambios a los datos de envío para ingesta y la publicación.In response, Partner Center commits the changes to the submission data for ingestion and publishing. Una vez finalizada correctamente la operación de confirmación, los cambios realizados en el envío se muestran en el centro de partners.After the commit operation succeeds, the changes to the submission are shown in Partner Center.

Para obtener más información sobre cómo se ajusta la operación de confirmación en el proceso de envío de un complemento mediante la API de envío de Microsoft Store, consulta Administrar envíos de complementos.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.

Requisitos previosPrerequisites

Para usar este método, primero debes hacer lo siguiente:To use this method, you need to first do the following:

SolicitudRequest

Este método tiene la siguiente sintaxis.This method has the following syntax. Consulta las siguientes secciones para ver ejemplos de uso y descripciones tanto del encabezado como del cuerpo de la solicitud.See the following sections for usage examples and descriptions of the header and request body.

MétodoMethod URI de la solicitudRequest URI
EXPONERPOST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}/submissions/{submissionId}/commit

Encabezado de la solicitudRequest header

HeaderHeader TipoType DescripciónDescription
AutorizaciónAuthorization stringstring Obligatorio.Required. El token de acceso de Azure AD en el formulario portador < token>.The Azure AD access token in the form Bearer <token>.

Parámetros de solicitudRequest parameters

NombreName TipoType DescripciónDescription
inAppProductIdinAppProductId stringstring Obligatorio.Required. El Id. de la Tienda del complemento que contiene el envío que deseas confirmar.The Store ID of the add-on that contains the submission you want to commit. El identificador de Store está disponible en el centro de partners, y se incluye en los datos de respuesta para las solicitudes a obtener todos los complementos y crear un complemento.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 stringstring Obligatorio.Required. El identificador del envío que deseas confirmar.The ID of the submission you want to commit. Este identificador está disponible en los datos de respuesta a las solicitudes para crear un envío de complemento.This ID is available in the response data for requests to create an add-on submission. Para un envío que se creó en el centro de partners, este identificador también está disponible en la dirección URL de la página de envío en el centro de partners.For a submission that was created in Partner Center, this ID is also available in the URL for the submission page in Partner Center.

Cuerpo de la solicitudRequest body

No incluyas un cuerpo de la solicitud para este método.Do not provide a request body for this method.

Ejemplo de solicitudRequest example

El siguiente ejemplo muestra cómo confirmar un envío de complemento.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>

RespuestaResponse

En el siguiente ejemplo se muestra el cuerpo de la respuesta JSON de una llamada satisfactoria a este método.The following example demonstrates the JSON response body for a successful call to this method. Para obtener más información acerca de los valores del cuerpo de respuesta, consulta las secciones siguientes.For more details about the values in the response body, see the following sections.

{
  "status": "CommitStarted"
}

Cuerpo de la respuestaResponse body

ValorValue TipoType DescripciónDescription
statusstatus stringstring Estado del envío.The status of the submission. Puede ser uno de los valores siguientes:This can be one of the following values:
  • NingunoNone
  • CanceledCanceled
  • PendingCommitPendingCommit
  • CommitStartedCommitStarted
  • CommitFailedCommitFailed
  • PendingPublicationPendingPublication
  • PublishingPublishing
  • PublishedPublished
  • PublishFailedPublishFailed
  • PreProcessingPreProcessing
  • PreProcessingFailedPreProcessingFailed
  • CertificationCertification
  • CertificationFailedCertificationFailed
  • PublicaciónRelease
  • ReleaseFailedReleaseFailed

Códigos de errorError codes

Si la solicitud no se puede completar correctamente, la respuesta contendrá uno de los siguientes códigos de error HTTP.If the request cannot be successfully completed, the response will contain one of the following HTTP error codes.

Código de errorError code DescripciónDescription
400400 Los parámetros de la solicitud no son válidos.The request parameters are invalid.
404404 No se pudo encontrar el envío especificado.The specified submission could not be found.
409409 Se encontró el envío especificado, pero no pudo confirmarse en su estado actual o el complemento utiliza una característica de centro de partners que es no compatible actualmente con la API de envío 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.