Obtener información sobre el despliegue para una presentación de aplicación

2025-06-10

Usa este método en la API de envío de Microsoft Store para obtener información sobre el despliegue de paquetes de un envío de un vuelo de paquetes. Para obtener más información sobre el proceso de creación de un envío de aplicación mediante la API de envío de Microsoft Store, consulta Administrar envíos de aplicaciones.

Prerrequisitos

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

Si aún no lo ha hecho, complete todos los requisitos previos para la API de envío de Microsoft Store.
Obtenga un token de acceso de Azure AD para usarlo en el encabezado de solicitud para este método. Después de obtener un token de acceso, tiene 60 minutos para usarlo antes de que expire. Una vez que expire el token, puede obtener uno nuevo.
Cree una solicitud para una de tus aplicaciones. Puedes hacerlo en el Centro de socios o mediante el método crear un envío de aplicación.

Solicitud

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	Solicitud de URI
OBTENER	`https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/packagerollout`

Cabecera de solicitud

Cabecera	Tipo	Descripción
Autorización	cuerda / cadena	Obligatorio. El token de acceso de Azure AD en la forma Bearer<token>.

Parámetros de solicitud

Nombre	Tipo	Descripción
applicationId	cuerda / cadena	Obligatorio. El identificador de la tienda de aplicaciones que contiene la presentación 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.
Id de envío	cuerda / cadena	Obligatorio. El identificador del 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 envío de aplicación. Para una presentación que se creó en el Centro de socios, este identificador también está disponible en la URL de la página de la presentación en el Centro de socios.

Cuerpo de la solicitud

No incluya un contenido de la 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 aplicación.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/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 exitosa a este método para el envío de una aplicación con la implementación gradual de paquetes habilitada. Para obtener más información sobre los valores del cuerpo de la respuesta, consulte el recurso de implementación de paquete .

{
    "isPackageRollout": true,
    "packageRolloutPercentage": 25.0,
    "packageRolloutStatus": "PackageRolloutInProgress",
    "fallbackSubmissionId": "1212922684621243058"
}

Si la presentación de la aplicación no tiene habilitada la implementación gradual de paquetes, se devolverá el cuerpo de respuesta siguiente.

{
    "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ó la solicitud.
409	El envío no pertenece a la aplicación especificada 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.

Compartir a través de