Compartir a través de

Crear un paquete de vuelo

Usa este método en la API de envío de Microsoft Store para crear un vuelo de paquete para una aplicación registrada en tu cuenta del Centro de partners.

Nota:

Este método crea un vuelo de paquete sin ninguna presentación. Para crear un envío para el vuelo de paquetes, consulta los métodos de Administrar envíos de vuelos de paquetes.

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.

Solicitud

Este método tiene la sintaxis siguiente. Consulte las secciones siguientes para ver ejemplos de uso y descripciones del encabezado y el cuerpo de la solicitud.

Método Solicitud de URI
PUBLICACIÓN https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights

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. ID de la Tienda de la aplicación para la que quieres crear un vuelo de paquetes. Para obtener más información sobre el identificador de la Tienda, consulta Ver los detalles de la identidad de la aplicación.

Cuerpo de la solicitud

El cuerpo de la solicitud tiene los parámetros siguientes.

Parámetro Tipo Descripción Obligatorio
nombre amistoso cuerda / cadena Nombre del paquete de vuelo, según lo especificado por el desarrollador. No
identificadores de grupo matriz Matriz de cadenas que contienen los identificadores de los grupos de vuelo asociados al vuelo de paquete. Para obtener más información sobre los grupos de vuelos, consulta Paquete de vuelos. No
rangoMásAltoQue cuerda / cadena El nombre amigable del paquete de vuelos que se clasifica inmediatamente más bajo que el paquete de vuelos actual. Si no establece este parámetro, el nuevo vuelo de paquetes tendrá el rango más alto de todos los vuelos de paquetes. Para obtener más información sobre la clasificación de grupos de vuelos, consulte Paquete de vuelos. No

Ejemplo de solicitud

En el ejemplo siguiente, se demuestra cómo crear un nuevo vuelo de paquete para una app que tenga el ID de la Tienda 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
}

Respuesta

En el ejemplo siguiente se muestra el cuerpo de la respuesta JSON para una llamada correcta a este método. Para obtener más información sobre los valores en el cuerpo de la respuesta, consulte las secciones siguientes.

{
  "flightId": "43e448df-97c9-4a43-a0bc-2a445e736bcd",
  "friendlyName": "myflight",
  "groupIds": [
    "0"
  ],
  "rankHigherThan": "671c2857-725e-4faf-9e9e-ea1191ef879c"
}

Cuerpo de respuesta

Importancia Tipo Descripción
flightId cuerda / cadena Identificador del paquete de vuelo. Este valor lo proporciona Partner Center.
nombre amistoso cuerda / cadena Nombre del paquete de vuelo, tal como se especifica en la solicitud.
identificadores de grupo matriz Un conjunto de cadenas que contiene los identificadores de los grupos de vuelo asociados al paquete de vuelo, tal como se especifica en la solicitud. Para obtener más información sobre los grupos de vuelos, consulta Paquete de vuelos.
rangoMásAltoQue cuerda / cadena Nombre amigable del paquete de vuelos que se clasifica justo por debajo del paquete de vuelos actual, como se especifica en la solicitud. Para obtener más información sobre la clasificación de grupos de vuelos, consulte Paquete de vuelos.

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.
409 No se pudo crear el vuelo del paquete debido a su estado actual, o la aplicación utiliza una característica del Centro de asociados que actualmente no es compatible con la API de envío de Microsoft Store.