Obtener la información de lanzamiento para un envío piloto
Usa este método en la API de envío de Microsoft Store para obtener información de lanzamiento de paquetes para un envío de paquete piloto. Para obtener más información sobre 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.
- 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 paquete piloto para una de las aplicaciones. Puedes hacerlo en el Centro de partners o puedes hacerlo mediante el método de creación de un envío de paquete piloto .
Solicitar
Este método tiene la sintaxis siguiente. Consulte las secciones siguientes para ver ejemplos de uso y descripciones de los parámetros de encabezado y solicitud.
| Método | URI de solicitud |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/packagerollout |
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 |
|---|---|---|
| applicationId | string | Necesario. El identificador de la Tienda de la aplicación que contiene el envío de paquete piloto con la información de lanzamiento del paquete que quieres obtener. Para obtener más información sobre el identificador de la Tienda, consulta Ver los detalles de la identidad de la aplicación. |
| flightId | string | Necesario. El identificador del paquete piloto que contiene el envío con la información de lanzamiento del paquete que desea obtener. 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. Identificador del envío con la información de lanzamiento del paquete que se va a obtener. 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 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 la información de lanzamiento del paquete para un envío de paquete piloto.
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243649/packagerollout 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 para un envío de paquete piloto con el lanzamiento gradual de paquetes habilitado. Para obtener más información sobre los valores en el cuerpo de la respuesta, consulte Recurso de lanzamiento de paquetes.
{
"isPackageRollout": true,
"packageRolloutPercentage": 25.0,
"packageRolloutStatus": "PackageRolloutInProgress",
"fallbackSubmissionId": "1212922684621243058"
}
Si el envío del paquete piloto no tiene habilitada la implementación gradual del paquete, se devolverá el siguiente cuerpo de respuesta.
{
"isPackageRollout": false,
"packageRolloutPercentage": 0.0,
"packageRolloutStatus": "PackageRolloutNotStarted",
"fallbackSubmissionId": "0"
}
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 del paquete piloto. |
| 409 | El envío de paquete piloto no pertenece al paquete piloto especificado o la aplicación usa una característica del Centro de partners que no es compatible actualmente con la API de envío de Microsoft Store. |