Obtener el estado de un envío de aplicaciónGet the status of an app submission

Use este método en la API de envío de Microsoft Store para obtener el estado de un envío de aplicación.Use this method in the Microsoft Store submission API to get the status of an app submission. Para obtener más información sobre el proceso de creación de un envío de aplicación mediante el Microsoft Store API de envío, consulte Administración de envíos de aplicaciones.For more information about the process of process of creating an app submission by using the Microsoft Store submission API, see Manage app submissions.

Requisitos previosPrerequisites

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

  • Si todavía no lo ha hecho, complete todos los requisitos previos de la API de envío de Microsoft Store.If you have not done so already, complete all the prerequisites for the Microsoft Store submission API.
  • Obtén un token de acceso de Azure AD para usarlo en el encabezado de la solicitud de este método.Obtain an Azure AD access token to use in the request header for this method. Una vez que haya obtenido un token de acceso, tiene 60 minutos para usarlo antes de que expire.After you obtain an access token, you have 60 minutes to use it before it expires. Si el token expira, puedes obtener uno nuevo.After the token expires, you can obtain a new one.

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

Encabezado de solicitudRequest header

EncabezadoHeader TipoType DescripciónDescription
AuthorizationAuthorization stringstring Necesario.Required. El token de acceso de Azure AD del formulario Bearer <token>.The Azure AD access token in the form Bearer <token>.

Parámetros de solicitudRequest parameters

NombreName TipoType DescripciónDescription
applicationIdapplicationId stringstring Necesario.Required. El Id. de la Tienda de la aplicación que contiene el envío cuyo estado quieres obtener.The Store ID of the app that contains the submission for which you want to get the status. Para obtener más información sobre el identificador de la Tienda, consulta Ver detalles de identidad de las aplicaciones.For more information about the Store ID, see View app identity details.
submissionIdsubmissionId stringstring Necesario.Required. El identificador del envío para el que quieres obtener el estado.The ID of the submission for which you want to get the status. Este identificador está disponible en los datos de respuesta para las solicitudes para crear un envío de aplicación.This ID is available in the response data for requests to create an app submission. En el caso de un envío creado en el centro de Partners, este identificador también está disponible en la dirección URL de la página de envío del 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

En el siguiente ejemplo se muestra cómo obtener el estado de un envío de aplicación.The following example demonstrates how to get the status of an app submission.

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

ResponseResponse

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. El cuerpo de la respuesta contiene información sobre el envío especificado.The response body contains information about the specified submission. 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": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
}

Cuerpo de la respuestaResponse body

ValueValue TipoType DescripciónDescription
statusstatus stringstring Estado del envío.The status of the submission. Puede ser uno de los siguientes valores:This can be one of the following values:
  • NoneNone
  • CanceledCanceled
  • PendingCommitPendingCommit
  • CommitStartedCommitStarted
  • CommitFailedCommitFailed
  • PendingPublicationPendingPublication
  • PublicaciónPublishing
  • PublicadoPublished
  • PublishFailedPublishFailed
  • PreProcessingPreProcessing
  • PreProcessingFailedPreProcessingFailed
  • CertificaciónCertification
  • CertificationFailedCertificationFailed
  • ReleaseRelease
  • ReleaseFailedReleaseFailed
statusDetailsstatusDetails objectobject Contiene detalles adicionales sobre el estado del envío, incluida la información sobre los errores.Contains additional details about the status of the submission, including information about any errors. Para obtener más información, consulta Recurso de detalles de estado.For more information, see the Status details resource.

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
404404 No se pudo encontrar el envío.The submission could not be found.
409409 La aplicación usa una característica del centro de partners que actualmente no es compatible con la API de envío de Microsoft Store.The app uses a Partner Center feature that is currently not supported by the Microsoft Store submission API.