Crear un envío de paquete por vuelo

2025-05-01

Usa este método en la API de presentación de Microsoft Store para crear una nueva presentación de un lanzamiento de paquete para una app. Después de crear correctamente un nuevo envío mediante este método, actualiza el envío para realizar los cambios necesarios en los datos de envío y, a continuación, confirma el envío para su integración y publicación.

Para obtener más información sobre cómo encaja este método en el proceso de creación de un envío de paquete piloto mediante la API de envío de Microsoft Store, consulta Administrar envíos de paquetes piloto.

Nota:

Este método crea un envío para un vuelo de paquete existente. Para crear un vuelo de paquete, use el método crear un vuelo de paquete.

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.
Cree un paquete de vuelo para una aplicación. Puedes hacer esto en el Centro de partners o mediante el método crear una versión de vuelo de paquete.

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/{flightId}/submissions`

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 lanzamiento de paquete. Para obtener más información sobre el identificador de la Tienda, consulta Ver los detalles de la identidad de la aplicación.
flightId	cuerda / cadena	Obligatorio. El ID del paquete de vuelo para el cual desea agregar la solicitud. Este identificador está disponible en los datos de respuesta de las solicitudes para crear un vuelo de paquete y obtener vuelos de paquete para una aplicación.

Cuerpo de la solicitud

No incluya un contenido de la solicitud para este método.

Ejemplo de solicitud

En el ejemplo siguiente se muestra cómo crear un nuevo envío de vuelo de paquete para una aplicación que tiene el ID de la Tienda 9WZDNCRD91MD.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions HTTP/1.1
Authorization: Bearer <your access token>

Respuesta

En el ejemplo siguiente se muestra el cuerpo de la respuesta JSON para una llamada correcta a este método. El cuerpo de la respuesta contiene información sobre la nueva presentación. Para obtener más información sobre los valores en el cuerpo de la respuesta, consulte recurso de envío de paquete de vuelo.

{
  "id": "1152921504621243649",
  "flightId": "cd2e368a-0da5-4026-9f34-0e7934bc6f23",
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
  "flightPackages": [
    {
      "fileName": "newPackage.appx",
      "fileStatus": "PendingUpload",
      "id": "",
      "version": "1.0.0.0",
      "languages": ["en-us"],
      "capabilities": [],
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None"
    }
  ],
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0.0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
  "fileUploadUrl": "https://productingestionbin1.blob.core.windows.net/ingestion/8b389577-5d5e-4cbe-a744-1ff2e97a9eb8?sv=2014-02-14&sr=b&sig=wgMCQPjPDkuuxNLkeG35rfHaMToebCxBNMPw7WABdXU%3D&se=2016-06-17T21:29:44Z&sp=rwl",
  "targetPublishMode": "Immediate",
  "targetPublishDate": "",
  "notesForCertification": "No special steps are required for certification of this app."
}

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	No se pudo crear la presentación del paquete porque la solicitud no es válida.
409	No se pudo crear el envío de paquete piloto debido al estado actual de la aplicación, 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.

Compartir a través de