Obtener un paquete piloto
Usa este método en la API de envío de Microsoft Store para obtener datos de un paquete piloto para una aplicación registrada en tu cuenta del Centro de partners.
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.
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 |
---|---|
GET | https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId} |
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 paquete piloto que quieres obtener. 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 se va a 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. |
Cuerpo de la solicitud
No incluyas un cuerpo de la solicitud para este método.
Ejemplo de solicitud
En el ejemplo siguiente se muestra cómo recuperar información sobre un paquete piloto con el identificador 43e448df-97c9-4a43-a0bc-2a445e736bcd para una aplicación con el Id. de la Tienda 9WZDNCRD91MD.
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd 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.
{
"flightId": "43e448df-97c9-4a43-a0bc-2a445e736bcd",
"friendlyName": "myflight",
"lastPublishedFlightSubmission": {
"id": "1152921504621086517",
"resourceLocation": "flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621086517"
},
"pendingFlightSubmission": {
"id": "115292150462124364",
"resourceLocation": "flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243647"
},
"groupIds": [
"0"
],
"rankHigherThan": "671c2857-725e-4faf-9e9e-ea1191ef879c"
}
Response body
Valor | Tipo | Descripción |
---|---|---|
flightId | string | El identificador del paquete piloto. Este valor lo proporciona el Centro de partners. |
friendlyName | string | El nombre del paquete piloto, según lo especifica el desarrollador. |
lastPublishedFlightSubmission | object | Un objeto que proporciona información sobre el último envío publicado para el paquete piloto. Para obtener más información, consulta la sección Objeto de envío a continuación. |
pendingFlightSubmission | object | Un objeto que proporciona información sobre el envío pendiente actualmente para el paquete piloto. Para obtener más información, consulta la sección Objeto de envío a continuación. |
groupIds | array | Una matriz de cadenas que contienen los identificadores de los grupos de pilotos asociados con el paquete piloto. Para obtener más información sobre los grupos de pilotos, consulta Paquetes piloto. |
rankHigherThan | string | El nombre descriptivo del paquete piloto que está clasificado inmediatamente por debajo del paquete piloto actual. Para obtener más información sobre la clasificación de grupos de pilotos, consulta Paquetes piloto. |
Objeto de envío
Los valores lastPublishedFlightSubmission y pendingFlightSubmission del cuerpo de respuesta contienen objetos que proporcionan información de recursos sobre un envío para el paquete piloto. Estos objetos tienen los siguientes valores.
Valor | Tipo | Descripción |
---|---|---|
id | string | Identificador del envío. |
resourceLocation | cadena | Ruta de acceso relativa que se puede anexar al URI de la solicitud de base https://manage.devcenter.microsoft.com/v1.0/my/ para recuperar los datos completos para el envío. |
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 | La solicitud no es válida. |
404 | No se pudo encontrar el paquete piloto especificado. |
409 | 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
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