Crear un paquete pilotoCreate a package flight

Use este método en el Microsoft Store API de envío para crear un paquete piloto para una aplicación registrada en su cuenta del centro de Partners.Use this method in the Microsoft Store submission API to create a package flight for an app that is registered to your Partner Center account.

Nota

Este método crea un paquete piloto sin envíos.This method creates a package flight without any submissions. Para crear un envío de paquete piloto, consulta los métodos de Administración de envíos de paquetes piloto.To create a submission for package flight, see the methods in Manage package flight submissions.

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
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights

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 sobre la que quieres crear un paquete piloto.The Store ID of the app for which you want to create a package flight. 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.

Cuerpo de la solicitudRequest body

El cuerpo de la solicitud tiene los siguientes parámetros.The request body has the following parameters.

ParámetroParameter TipoType DescripciónDescription ObligatorioRequired
friendlyNamefriendlyName stringstring El nombre del paquete piloto, según lo especifica el desarrollador.The name of the package flight, as specified by the developer. NoNo
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. NoNo
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. Si no estableces este parámetro, el nuevo paquete piloto tendrá la puntuación más alta de todos los paquetes piloto.If you do not set this parameter, the new package flight will have the highest rank of all package flights. 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. NoNo

Ejemplo de solicitudRequest example

El siguiente ejemplo muestra cómo crear un nuevo paquete piloto para una aplicación que tiene el Id. de la Tienda 9WZDNCRD911W.The following example demonstrates how to create a new package flight for an app that has the Store ID 9WZDNCRD911W.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1Q...
Content-Type: application/json
{
  "friendlyName": "myflight",
  "groupIds": [
    0
  ],
  "rankHigherThan": null
}

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",
  "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, como se especifica en la solicitud.The name of the package flight, as specified in the request.
groupIdsgroupIds arrayarray Una matriz de cadenas que contengan los identificadores de los grupos piloto asociados con el paquete piloto, como se especifica en la solicitud.An array of strings that contain the IDs of the flight groups that are associated with the package flight, as specified in the request. 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 menor que el paquete piloto actual, como se especifica en la solicitud.The friendly name of the package flight that is ranked immediately lower than the current package flight, as specified in the request. 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.

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.
409409 No se pudo crear el paquete piloto debido a su estado actual 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.The package flight could not be created because of its current state, or the app uses a Partner Center feature that is currently not supported by the Microsoft Store submission API.