Commit a package flight submission (Confirmar un envío de paquete piloto)
Usa este método en la API de envío de Microsoft Store para confirmar un envío de paquete piloto nuevo o actualizado al Centro de partners. La acción de confirmación alerta al Centro de partners de que se han cargado los datos de envío (incluidos los paquetes relacionados). En respuesta, el Centro de partners confirma los cambios en los datos de envío para la ingesta y publicación. Una vez que la operación de confirmación se realiza correctamente, los cambios en el envío se muestran en el Centro de partners.
Para obtener más información sobre cómo encaja la operación de confirmación en el proceso de creación de un envío de paquete piloto mediante la API de envío de Microsoft Store, consulta Administrar envíos de paquetes piloto.
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.
- Obtén un token de acceso de Azure AD para usarlo en el encabezado de la solicitud de este método. Una vez que haya obtenido un token de acceso, tiene 60 minutos para usarlo antes de que expire. Si el token expira, puedes obtener uno nuevo.
- Crea un envío de paquete piloto y después actualiza el envío con cualquier cambio necesario en los datos de envío.
Solicitud
Este método tiene la siguiente sintaxis. Consulta las siguientes secciones para ver ejemplos de uso y descripciones tanto del encabezado como del cuerpo de la solicitud.
Método | URI de solicitud |
---|---|
POST | https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/commit |
Encabezado de solicitud
Encabezado | Tipo | Descripción |
---|---|---|
Authorization | string | Necesario. Token de acceso de Azure AD con el formato Token de portador<>. |
Parámetros de solicitud
Nombre | Tipo | Descripción |
---|---|---|
applicationId | string | Necesario. El Id. de la Tienda de la aplicación que contiene el envío de paquete piloto que quieres confirmar. El id. de la Tienda para la aplicación está disponible en el Centro de partners. |
flightId | string | Necesario. El identificador del paquete piloto que contiene el envío que se va a confirmar. Este identificador está disponible en los datos de respuesta de las solicitudes para crear un paquete piloto y obtener paquetes piloto para una aplicación. Para un vuelo creado en el Centro de partners, este identificador también está disponible en la dirección URL de la página piloto del Centro de partners. |
submissionId | string | Necesario. El identificador del envío que se va a confirmar. Este identificador está disponible en los datos de respuesta de las solicitudes para crear un envío de paquete piloto. 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 del Centro de partners. |
Cuerpo de la solicitud
No incluyas un cuerpo de la solicitud para este método.
Ejemplo de solicitud
El siguiente ejemplo muestra cómo confirmar un envío de paquete piloto.
POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243649/commit HTTP/1.1
Authorization: Bearer <your access token>
Response
En el siguiente ejemplo se muestra el cuerpo de la respuesta JSON de una llamada satisfactoria a este método. Para obtener más información acerca de los valores del cuerpo de respuesta, consulta las secciones siguientes.
{
"status": "CommitStarted"
}
Response body
Valor | Tipo | Descripción |
---|---|---|
status | string | Estado del envío. Puede ser uno de los siguientes valores:
|
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 |
---|---|
400 | Los parámetros de la solicitud no son válidos. |
404 | No se pudo encontrar el envío especificado. |
409 | Se encontró el envío especificado, pero no se pudo confirmar en su estado actual, o 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. |
Temas relacionados
- Creación y administración de envíos mediante el uso de servicios de Microsoft Store
- Manage package flight submissions (Administrar envíos de paquetes piloto)
- Get a package flight submission (Obtener un envío de paquete piloto)
- Crear un envío de paquete piloto
- Actualización de un envío de paquete piloto
- Eliminar un envío de paquete piloto
- Get the status of a package flight submission (Obtener el estado de un envío de paquete piloto)
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de