Obtener un paquete pilotoGet a package flight

Use 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 la cuenta del centro de Partners.Use this method in the Microsoft Store submission API to get data for a package flight for an app that is registered to your Partner Center account.

Requisitos previosPrerequisites

Para usar este método, primero debes hacer lo siguiente:To use this method, you need to first do the following:

  • Si todavía no lo ha hecho, complete todos los requisitos previos de la API de envío de Microsoft Store.If you have not done so already, complete all the prerequisites for the Microsoft Store submission API.
  • Obtén un token de acceso de Azure AD para usarlo en el encabezado de la solicitud de este método.Obtain an Azure AD access token to use in the request header for this method. Una vez que haya obtenido un token de acceso, tiene 60 minutos para usarlo antes de que expire.After you obtain an access token, you have 60 minutes to use it before it expires. Si el token expira, puedes obtener uno nuevo.After the token expires, you can obtain a new one.

SolicitudRequest

Este método tiene la siguiente sintaxis.This method has the following syntax. Consulta las siguientes secciones para ver ejemplos de uso y descripciones tanto del encabezado como del cuerpo de la solicitud.See the following sections for usage examples and descriptions of the header and request body.

MétodoMethod URI de solicitudRequest URI
GETGET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}

Encabezado de solicitudRequest header

EncabezadoHeader TipoType DescripciónDescription
AuthorizationAuthorization stringstring Necesario.Required. El token de acceso de Azure AD del formulario Bearer <token>.The Azure AD access token in the form Bearer <token>.

Parámetros de solicitudRequest parameters

NombreName TipoType DescripciónDescription
applicationIdapplicationId stringstring Necesario.Required. El Id. de la Tienda de la aplicación que contiene el paquete piloto que quieres obtener.The Store ID of the app that contains the package flight you want to get. El identificador de almacén de la aplicación está disponible en el centro de Partners.The Store ID for the app is available in Partner Center.
flightIdflightId stringstring Necesario.Required. El identificador del paquete piloto que se va a obtener.The ID of the package flight to get. Este identificador está disponible en los datos de respuesta para las solicitudes para crear un paquete piloto y obtener paquetes piloto para una aplicación.This ID is available in the response data for requests to create a package flight and get package flights for an app. En el caso de un vuelo creado en el centro de Partners, este identificador también está disponible en la dirección URL de la página de vuelo del centro de Partners.For a flight that was created in Partner Center, this ID is also available in the URL for the flight page in Partner Center.

Cuerpo de la solicitudRequest body

No incluyas un cuerpo de la solicitud para este método.Do not provide a request body for this method.

Ejemplo de solicitudRequest example

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.The following example demonstrates how to retrieve information about a package flight with the ID 43e448df-97c9-4a43-a0bc-2a445e736bcd for an app with the Store ID value 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>

ResponseResponse

En el siguiente ejemplo se muestra el cuerpo de la respuesta JSON de una llamada satisfactoria a este método.The following example demonstrates the JSON response body for a successful call to this method. Para obtener más información acerca de los valores del cuerpo de respuesta, consulta las secciones siguientes.For more details about the values in the response body, see the following sections.

{
  "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"
}

Cuerpo de la respuestaResponse body

ValueValue TipoType DescripciónDescription
flightIdflightId stringstring El identificador del paquete piloto.The ID for the package flight. Este valor lo proporciona el centro de Partners.This value is supplied by Partner Center.
friendlyNamefriendlyName stringstring El nombre del paquete piloto, según lo especifica el desarrollador.The name of the package flight, as specified by the developer.
lastPublishedFlightSubmissionlastPublishedFlightSubmission objectobject Un objeto que proporciona información sobre el último envío publicado para el paquete piloto.An object that provides information about the last published submission for the package flight. Para obtener más información, consulta la sección Objeto de envío a continuación.For more information, see the Submission object section below.
pendingFlightSubmissionpendingFlightSubmission objectobject Un objeto que proporciona información sobre el envío pendiente actualmente para el paquete piloto.An object that provides information about the current pending submission for the package flight. Para obtener más información, consulta la sección Objeto de envío a continuación.For more information, see the Submission object section below.
groupIdsgroupIds arrayarray Una matriz de cadenas que contienen los identificadores de los grupos de pilotos asociados con el paquete piloto.An array of strings that contain the IDs of the flight groups that are associated with the package flight. Para obtener más información sobre los grupos de pilotos, consulta Paquetes piloto.For more information about flight groups, see Package flights.
rankHigherThanrankHigherThan stringstring El nombre descriptivo del paquete piloto que está clasificado inmediatamente por debajo del paquete piloto actual.The friendly name of the package flight that is ranked immediately lower than the current package flight. Para obtener más información sobre la clasificación de grupos de pilotos, consulta Paquetes piloto.For more information about ranking flight groups, see Package flights.

Objeto de envíoSubmission object

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.The lastPublishedFlightSubmission and pendingFlightSubmission values in the response body contain objects that provide resource information about a submission for the package flight. Estos objetos tienen los siguientes valores.These objects have the following values.

ValueValue TipoType DescripciónDescription
idid stringstring Identificador del envío.The ID of the submission.
resourceLocationresourceLocation stringstring 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.A relative path that you can append to the base https://manage.devcenter.microsoft.com/v1.0/my/ request URI to retrieve the complete data for the submission.

Códigos de errorError codes

Si la solicitud no se puede completar correctamente, la respuesta contendrá uno de los siguientes códigos de error HTTP.If the request cannot be successfully completed, the response will contain one of the following HTTP error codes.

Código de errorError code DescripciónDescription
400400 La solicitud no es válida.The request is invalid.
404404 No se pudo encontrar el paquete piloto especificado.The specified package flight could not be found.
409409 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.The app uses a Partner Center feature that is currently not supported by the Microsoft Store submission API.