Compartir a través de

Crear un envío de paquete piloto

  • Artículo

Usa este método en la API de envío de Microsoft Store para crear un nuevo envío para un paquete piloto para una aplicación. Después de crear correctamente un nuevo envío mediante este método, actualice el envío para realizar los cambios necesarios en los datos de envío y, a continuación , confirme el envío para la ingesta 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 paquete piloto existente. Para crear un paquete piloto, use el método create a package flight .

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.
  • Cree un paquete piloto para una aplicación. Puedes hacerlo en el Centro de partners o puedes hacerlo mediante el método create a package flight .

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

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 envío de 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.
flightId string Necesario. Identificador del paquete piloto para el que desea agregar el envío. Este identificador está disponible en los datos de respuesta de las solicitudes para crear un paquete piloto y obtener paquetes piloto para una aplicación.

Cuerpo de la solicitud

No proporcione un cuerpo de solicitud para este método.

Ejemplo de solicitud

En el ejemplo siguiente se muestra cómo crear un nuevo envío de paquete piloto para una aplicación que tenga 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 el nuevo envío. Para obtener más información sobre los valores en el cuerpo de la respuesta, consulte Recurso de envío de paquete piloto.

{
  "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 Description
400 No se pudo crear el envío del paquete piloto porque la solicitud no es válida.
409 No se pudo crear el envío del 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.