Crear un envío de paquete pilotoCreate a package flight submission

Use este método en el Microsoft Store API de envío para crear un nuevo envío de un paquete piloto para una aplicación.Use this method in the Microsoft Store submission API to create a new submission for a package flight for an app. Después de crear correctamente un nuevo envío mediante este método, actualiza el envío para realizar los cambios necesarios a los datos de envío y luego confirma el envío para la recopilación y la publicación.After you successfully create a new submission by using this method, update the submission to make any necessary changes to the submission data, and then commit the submission for ingestion and publishing.

Para obtener más información sobre cómo encaja este método en el proceso de creación de un envío de paquetes piloto mediante el Microsoft Store API de envío, consulte administrar envíos de paquetes de paquetes.For more information about how this method fits into the process of creating a package flight submission by using the Microsoft Store submission API, see Manage package flight submissions.

Nota

Este método crea un envío para un paquete piloto existente.This method creates a submission for an existing package flight. Para crear un paquete piloto, usa el método de creación de un paquete piloto.To create a package flight, use the create a package flight method.

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.
  • Cree un paquete piloto para una aplicación.Create a package flight for an app. Puede hacerlo en el centro de Partners o puede hacerlo mediante el método crear un paquete piloto .You can do this in Partner Center, or you can do this by using the create a package flight method.

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

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. Id. de la Tienda de la aplicación para la cual quieres crear un envío de paquete piloto.The Store ID of the app for which you want to create a package flight submission. 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.
flightIdflightId stringstring Necesario.Required. La Id. del paquete piloto para el cual quieres añadir el envío.The ID of the package flight for which you want to add the submission. Este identificador está disponible en los datos de respuesta para las solicitudes para crear un paquete piloto y obtener paquetes piloto para una aplicación.This ID is available in the response data for requests to create a package flight and get package flights for an app.

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.

Ejemplo de solicitudRequest example

El siguiente ejemplo muestra cómo crear un nuevo envío de paquete piloto para una aplicación que tiene la Id. de la Tienda 9WZDNCRD91MD.The following example demonstrates how to create a new package flight submission for an app that has the Store ID 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>

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. El cuerpo de la respuesta contiene información sobre el nuevo envío.The response body contains information about the new submission. Para obtener más información acerca de los valores que se encuentran en el cuerpo de la respuesta, consulta Package flight submission resource (Recurso de envío del paquete piloto).For more details about the values in the response body, see Package flight submission resource.

{
  "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 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 No se pudo crear el envío del paquete piloto porque la solicitud no es válida.The package flight submission could not be created because the request is invalid.
409409 No se pudo crear el envío de paquetes 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.The package flight submission could not be created because of the current state of the app, or the app uses a Partner Center feature that is currently not supported by the Microsoft Store submission API.