Obtener paquetes piloto para una aplicaciónGet package flights for an app

Use este método en la API de envío de Microsoft Store para mostrar los vuelos de paquete de una aplicación registrada en la cuenta del centro de Partners.Use this method in the Microsoft Store submission API to list the package flights for an app that is registered to your Partner Center account. Para obtener más información acerca de los paquetes piloto, consulta Paquetes piloto.For more information about package flights, see Package flights.

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}/listflights

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 ObligatorioRequired
applicationIdapplicationId stringstring El identificador de la Tienda de la aplicación para la que quieres recuperar paquetes piloto.The Store ID of the app for which you want to retrieve the package flights. Para obtener más información sobre el identificador de la Tienda, consulta Ver detalles de identidad de las aplicaciones.For more information about the Store ID, see View app identity details. Yes
toptop intint Número de elementos que se devolverán en la solicitud (es decir, el número de paquetes piloto que se devolverán).The number of items to return in the request (that is, the number of package flights to return). Si los paquetes piloto de tu cuenta superan el valor especificado en la consulta, el cuerpo de la respuesta incluirá una ruta de acceso al URI relativa que puedes anexar al URI del método para solicitar la siguiente página de datos.If your account has more package flights than the value you specify in the query, the response body includes a relative URI path that you can append to the method URI to request the next page of data. NoNo
skipskip intint El número de elementos que se omitirán en la consulta antes de devolver los elementos restantes.The number of items to bypass in the query before returning the remaining items. Usa este parámetro para consultar conjuntos de datos.Use this parameter to page through data sets. Por ejemplo, top = 10 y skip = 0 recuperan los elementos del 1 al 10, mientras que top = 10 y skip = 10 recuperan los elementos del 11 al 20, y así sucesivamente.For example, top=10 and skip=0 retrieves items 1 through 10, top=10 and skip=10 retrieves items 11 through 20, and so on. NoNo

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.

Ejemplos de solicitudRequest examples

En el siguiente ejemplo se muestra cómo enumerar todos los paquetes piloto de una aplicación.The following example demonstrates how to list all the package flights for an app.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/listflights HTTP/1.1
Authorization: Bearer <your access token>

En el siguiente ejemplo se muestra cómo enumerar el primer paquete piloto de una aplicación.The following example demonstrates how to list the first package flight for an app.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/listflights?top=1 HTTP/1.1
Authorization: Bearer <your access token>

ResponseResponse

En el siguiente ejemplo se muestra el cuerpo de respuesta JSON que devuelve una solicitud correcta para el primer paquete piloto de una aplicación con un total de tres paquetes piloto.The following example demonstrates the JSON response body returned by a successful request for the first package flight for an app with three total package flights. Para obtener más información acerca de los valores del cuerpo de respuesta, consulta la siguiente sección.For more details about the values in the response body, see the following section.

{
  "value": [
    {
      "flightId": "7bfc11d5-f710-47c5-8a98-e04bb5aad310",
      "friendlyName": "myflight",
      "lastPublishedFlightSubmission": {
        "id": "1152921504621086517",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621086517"
      },
      "pendingFlightSubmission": {
        "id": "1152921504621215786",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621215786"
      },
      "groupIds": [
        "1152921504606962205"
      ],
      "rankHigherThan": "Non-flighted submission"
    }
  ],
  "totalCount": 3
}

Cuerpo de la respuestaResponse body

ValueValue TipoType DescripciónDescription
@nextLink stringstring Si hay páginas adicionales de datos, esta cadena contiene una ruta de acceso relativa que se puede anexar al URI de la solicitud de base https://manage.devcenter.microsoft.com/v1.0/my/ para solicitar la siguiente página de datos.If there are additional pages of data, this string contains a relative path that you can append to the base https://manage.devcenter.microsoft.com/v1.0/my/ request URI to request the next page of data. Por ejemplo, si el parámetro Top del cuerpo de la solicitud inicial se establece en 2 pero hay cuatro vuelos de paquete para la aplicación, el cuerpo de la respuesta incluirá un @nextLink valor de applications/{applicationid}/listflights/?skip=2&top=2 , que indica que se puede llamar https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationid}/listflights/?skip=2&top=2 a para solicitar los dos vuelos de paquetes siguientes.For example, if the top parameter of the initial request body is set to 2 but there are 4 package flights for the app, the response body will include a @nextLink value of applications/{applicationid}/listflights/?skip=2&top=2, which indicates that you can call https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationid}/listflights/?skip=2&top=2 to request the next 2 package flights.
valuevalue arrayarray Una matriz de objetos que proporcionan información acerca de los paquetes piloto de la aplicación especificada.An array of objects that provide information about package flights for the specified app. Para obtener más información sobre los datos de cada objeto, consulta Recurso de piloto.For more information about the data in each object, see Flight resource.
totalCounttotalCount intint El número total de filas del resultado de datos de la consulta (es decir, el número total de paquetes piloto de la aplicación especificada).The total number of rows in the data result for the query (that is, the total number of package flights for the specified app).

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
404404 No se encontró ningún paquete piloto.No package flights were 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.