Compartir a través de

Obtener el estado de un envío de complemento

  • Artículo

Usa este método en la API de envío de Microsoft Store para obtener el estado de un envío de complemento (también conocido como producto desde la aplicación o IAP). Para obtener más información sobre el proceso de creación de un envío de complemento mediante la API de envío de Microsoft Store, consulta Administrar envíos de complementos.

Requisitos previos

Para usar este método, primero debes hacer lo siguiente:

  • Si aún no lo ha hecho, complete todos los requisitos previos para la API de envío de Microsoft Store.
  • Consigue un token de acceso a Azure AD para utilizarlo en el encabezado de solicitud de este método. Una vez que haya obtenido un token de acceso, tiene 60 minutos para usarlo antes de que expire. Una vez que expire el token, puede obtener uno nuevo.
  • Cree un envío de complemento para una de las aplicaciones. Puede hacerlo en el Centro de partners o puede hacerlo mediante el método Crear un envío de complemento.

Solicitar

Este método tiene la sintaxis siguiente. Consulte las secciones siguientes para ver ejemplos de uso y descripciones del encabezado y el cuerpo de la solicitud.

Método URI de solicitud
GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}/submissions/{submissionId}/status

Encabezado de solicitud

Encabezado Tipo Descripción
Autorización string Necesario. Token de acceso de Azure AD con el formato Token<de portador>.

Parámetros de solicitud

Nombre Escribir Descripción
inAppProductId string Necesario. Identificador de la Tienda del complemento que contiene el envío para el que quieres obtener el estado. El identificador de la Tienda está disponible en el Centro de partners.
submissionId string Necesario. Identificador del envío para el que desea obtener el estado. Este identificador está disponible en los datos de respuesta de las solicitudes para crear un envío de complemento. Para 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 en el Centro de partners.

Cuerpo de la solicitud

No proporcione un cuerpo de solicitud para este método.

Ejemplo de solicitud

En el ejemplo siguiente se muestra cómo obtener el estado de un envío de complemento.

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

Respuesta

En el ejemplo siguiente se muestra el cuerpo de la respuesta JSON para una llamada correcta a este método. El cuerpo de la respuesta contiene información sobre el envío especificado. Para obtener más información sobre los valores en el cuerpo de la respuesta, consulte las secciones siguientes.

{
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
}

Cuerpo de la respuesta

Valor Tipo Descripción
estado string El estado del envío. Este puede ser uno de los siguientes valores:
  • None
  • Canceled
  • PendingCommit
  • CommitStarted
  • CommitFailed
  • PendingPublication
  • Publicación
  • Publicado
  • PublishFailed
  • PreProcessing
  • PreProcessingFailed
  • Certificación
  • CertificationFailed
  • Versión
  • ReleaseFailed
statusDetails objeto Contiene detalles adicionales sobre el estado del envío, incluida la información sobre los errores. Para obtener más información, consulte Recurso de detalles de estado.

Códigos de error

Si la solicitud no se puede completar correctamente, la respuesta contendrá uno de los siguientes códigos de error HTTP.

Código de error Descripción
404 No se encontró el envío.
409 El complemento usa una característica del Centro de partners que actualmente no es compatible con la API de envío de Microsoft Store.