Compartir a través de

Crear un paquete piloto

  • Artículo

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

Nota:

Este método crea un paquete piloto sin envíos. Para crear un envío para paquete piloto, consulta los métodos en Administrar envíos de paquetes piloto.

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.
  • Consigue un token de acceso a Azure AD para utilizarlo en el encabezado de solicitud de este método. Una vez que haya obtenido un token de acceso, tiene 60 minutos para usarlo antes de que expire. Una vez que expire el token, puede obtener uno nuevo.

Solicitar

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

Encabezado de solicitud

Encabezado Tipo Descripción
Autorización string Necesario. Token de acceso de Azure AD con el formato Token<de portador>.

Parámetros de solicitud

Nombre Escribir Descripción
applicationId string Necesario. Id. de la Tienda de la aplicación para la que quieres crear un paquete piloto. 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
friendlyName string Nombre del paquete piloto, según lo especificado por el desarrollador. No
groupIds array Matriz de cadenas que contienen los identificadores de los grupos piloto asociados al paquete piloto. Para obtener más información sobre los grupos piloto, consulta Paquetes piloto. No
rankHigherThan string Nombre descriptivo del paquete piloto que se clasifica inmediatamente más bajo que el paquete piloto actual. Si no establece este parámetro, el nuevo paquete piloto tendrá el rango más alto de todos los paquetes piloto. Para obtener más información sobre la clasificación de grupos piloto, consulta Paquetes piloto. No

Ejemplo de solicitud

En el ejemplo siguiente se muestra cómo crear un paquete piloto para una aplicación 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 la respuesta

Valor Tipo Descripción
flightId string Identificador del paquete piloto. Este valor lo proporciona el Centro de partners.
friendlyName string Nombre del paquete piloto, tal como se especifica en la solicitud.
groupIds array Matriz de cadenas que contienen los identificadores de los grupos piloto asociados al paquete piloto, tal como se especifica en la solicitud. Para obtener más información sobre los grupos piloto, consulta Paquetes piloto.
rankHigherThan string Nombre descriptivo del paquete piloto que se clasifica inmediatamente inferior al paquete piloto actual, como se especifica en la solicitud. Para obtener más información sobre la clasificación de grupos piloto, consulta Paquetes piloto.

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 Description
400 La solicitud no es válida.
409 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.