Manage package flight submissions (Administrar envíos de paquetes piloto)Manage package flight submissions

La API de envío de Microsoft Store proporciona métodos que puede usar para administrar los envíos de paquetes de vuelos para las aplicaciones, incluidas las implementaciones de paquetes graduales.The Microsoft Store submission API provides methods you can use to manage package flight submissions for your apps, including gradual package rollouts. Para ver una introducción a la API de envío de Microsoft Store, incluidos los requisitos previos para el uso de la API, consulte crear y administrar envíos con Microsoft Store Services.For an introduction to the Microsoft Store submission API, including prerequisites for using the API, see Create and manage submissions using Microsoft Store services.

Importante

Si usa la API de envío de Microsoft Store para crear un envío para un paquete piloto, asegúrese de realizar más cambios en el envío solo mediante la API, en lugar del centro de Partners.If you use the Microsoft Store submission API to create a submission for a package flight, be sure to make further changes to the submission only by using the API, rather than Partner Center. Si usa el panel para cambiar un envío que creó originalmente con la API, ya no podrá cambiar o confirmar el envío mediante la API...If you use the dashboard to change a submission that you originally created by using the API, you will no longer be able to change or commit that submission by using the API. En algunos casos, el envío podría quedar en un estado de error en el que no se puede continuar en el proceso de envío.In some cases, the submission could be left in an error state where it cannot proceed in the submission process. Si esto ocurre, debe eliminar el envío y crear un nuevo envío.If this occurs, you must delete the submission and create a new submission.

Métodos para administrar envíos de paquetes pilotoMethods for managing package flight submissions

Usa los siguientes métodos para obtener, crear, actualizar, confirmar o eliminar un envío de paquete piloto.Use the following methods to get, create, update, commit, or delete a package flight submission. Antes de poder usar estos métodos, el paquete piloto debe existir en el centro de Partners.Before you can use these methods, the package flight must already exist in Partner Center. Puede crear un paquete piloto en el centro de Partners o mediante el Microsoft Store métodos de API de envío descritos en administrar paquetes piloto.You can create a package flight in Partner Center or by using the Microsoft Store submission API methods in described in Manage package flights.

MétodoMethod URIURI DescripciónDescription
GETGET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId} Obtener un envío de paquete piloto existenteGet an existing package flight submission
GETGET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/status Obtener el estado de un envío de paquete piloto existenteGet the status of an existing package flight submission
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions Crear un nuevo envío de paquete pilotoCreate a new package flight submission
PUTPUT https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId} Actualizar un envío de paquete piloto existenteUpdate an existing package flight submission
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/commit Confirmar un envío de paquete piloto nuevo o actualizadoCommit a new or updated package flight submission
DeleteDELETE https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId} Eliminar un envío de paquete pilotoDelete a package flight submission

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

Para crear un envío de un paquete piloto, sigue este proceso.To create a submission for a package flight, follow this process.

  1. Si todavía no lo ha hecho, complete los requisitos previos descritos en creación y administración de envíos con Microsoft Store Services, incluida la Asociación de una aplicación Azure ad con la cuenta del centro de Partners y la obtención del identificador de cliente y la clave.If you have not yet done so, complete the prerequisites described in Create and manage submissions using Microsoft Store services, including associating an Azure AD application with your Partner Center account and obtaining your client ID and key. Solo tienes que hacerlo una vez; cuando tengas el identificador y la clave de cliente, puedes volver a usarlos siempre que necesites crear un nuevo token de acceso de Azure AD.You only need to do this one time; after you have the client ID and key, you can reuse them any time you need to create a new Azure AD access token.

  2. Obtener un token de acceso Azure ad.Obtain an Azure AD access token. Debe pasar este token de acceso a los métodos de la API de envío de Microsoft Store.You must pass this access token to the methods in the Microsoft Store submission API. 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.

  3. Cree un envío de paquetes piloto ejecutando el método siguiente en la API de envío de Microsoft Store.Create a package flight submission by executing the following method in the Microsoft Store submission API. Este método crea un nuevo envío en curso, que es una copia de tu último envío publicado.This method creates a new in-progress submission, which is a copy of your last published submission.

    POST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions
    

    El cuerpo de la respuesta contiene un recurso de envío de vuelo que incluye el identificador del nuevo envío, el URI de la firma de acceso compartido (SAS) para cargar los paquetes para el envío a Azure BLOB Storage, y los datos para el nuevo envío (incluidos todos los anuncios e información de precios).The response body contains a flight submission resource that includes the ID of the new submission, the shared access signature (SAS) URI for uploading any packages for the submission to Azure Blob storage, and the data for the new submission (including all the listings and pricing information).

    Nota

    Un URI de SAS proporciona acceso a un recurso seguro en Azure Storage sin necesidad de claves de cuenta.A SAS URI provides access to a secure resource in Azure storage without requiring account keys. Para obtener información general sobre los URI de SAS y su uso con Azure Blob Storage, consulta Shared Access Signatures, Part 1: Understanding the SAS model (Firmas de acceso compartido, parte 1: información sobre el modelo SAS) y Firmas de acceso compartido, Parte 2: Creación y uso de una SAS con Almacenamiento de blobs.For background information about SAS URIs and their use with Azure Blob storage, see Shared Access Signatures, Part 1: Understanding the SAS model and Shared Access Signatures, Part 2: Create and use a SAS with Blob storage.

  4. Si estás agregando nuevos paquetes para el envío, prepara los paquetes y agrégalos a un archivo ZIP.If you are adding new packages for the submission, prepare the packages and add them to a ZIP archive.

  5. Revise los datos de envío de vuelos con los cambios necesarios para el nuevo envío y ejecute el método siguiente para actualizar el envío de paquetes piloto.Revise the flight submission data with any required changes for the new submission, and execute the following method to update the package flight submission.

    PUT https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}
    

    Nota

    Si va a agregar nuevos paquetes para el envío, asegúrese de actualizar los datos de envío para que hagan referencia al nombre y la ruta de acceso relativa de estos archivos en el archivo ZIP.If you are adding new packages for the submission, make sure you update the submission data to refer to the name and relative path of these files in the ZIP archive.

  6. Si estás agregando nuevos paquetes para el envío, carga el archivo ZIP en Azure Blob Storage usando el URI de SAS que se proporcionó en el cuerpo de la respuesta del método POST que llamaste antes.If you are adding new packages for the submission, upload the ZIP archive to Azure Blob storage using the SAS URI that was provided in the response body of the POST method you called earlier. Hay varias bibliotecas de Azure, que puedes usar para hacer esto en una variedad de plataformas, como:There are different Azure libraries you can use to do this on a variety of platforms, including:

    En el siguiente ejemplo de código C# se muestra cómo cargar el archivo ZIP en Azure Blob Storage usando la clase CloudBlockBlob en la biblioteca de cliente de Azure Storage para. NET.The following C# code example demonstrates how to upload a ZIP archive to Azure Blob storage using the CloudBlockBlob class in the Azure Storage Client Library for .NET. En este ejemplo se supone que el archivo ZIP ya se ha escrito en un objeto de secuencia.This example assumes that the ZIP archive has already been written to a stream object.

    string sasUrl = "https://productingestionbin1.blob.core.windows.net/ingestion/26920f66-b592-4439-9a9d-fb0f014902ec?sv=2014-02-14&sr=b&sig=usAN0kNFNnYE2tGQBI%2BARQWejX1Guiz7hdFtRhyK%2Bog%3D&se=2016-06-17T20:45:51Z&sp=rwl";
    Microsoft.WindowsAzure.Storage.Blob.CloudBlockBlob blockBob =
        new Microsoft.WindowsAzure.Storage.Blob.CloudBlockBlob(new System.Uri(sasUrl));
    await blockBob.UploadFromStreamAsync(stream);
    
  7. Ejecuta el siguiente método para confirmar el envío de paquete piloto.Commit the package flight submission by executing the following method. Esto le avisará al centro de Partners de que ha terminado con el envío y que las actualizaciones deben aplicarse ahora a su cuenta.This will alert Partner Center that you are done with your submission and that your updates should now be applied to your account.

    POST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/commit
    
  8. Comprueba el estado de confirmación ejecutando el siguiente método para obtener el estado del envío de paquete piloto.Check on the commit status by executing the following method to get the status of the package flight submission.

    GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/status
    

    Para confirmar el estado del envío, revisa el valor de status en el cuerpo de la respuesta.To confirm the submission status, review the status value in the response body. Este valor debe cambiar de CommitStarted a PreProcessing si la solicitud se realiza correctamente o a CommitFailed si hay errores en la solicitud.This value should change from CommitStarted to either PreProcessing if the request succeeds or to CommitFailed if there are errors in the request. Si hay errores, el campo statusDetails contendrá más detalles sobre el error.If there are errors, the statusDetails field contains further details about the error.

  9. Después de completarse correctamente la confirmación, el envío se remite a la Tienda para su ingesta.After the commit has successfully completed, the submission is sent to the Store for ingestion. Puede seguir supervisando el progreso del envío con el método anterior o visitando el centro de Partners.You can continue to monitor the submission progress by using the previous method, or by visiting Partner Center.

Ejemplos de códigoCode examples

Los siguientes artículos proporcionan ejemplos de código detallados que muestran cómo crear un envío de paquete piloto en varios lenguajes de programación:The following articles provide detailed code examples that demonstrate how to create a package flight submission in several different programming languages:

Módulo de PowerShell de StoreBrokerStoreBroker PowerShell module

Como alternativa a llamar a la API de envío de Microsoft Store directamente, también proporcionamos un módulo de PowerShell de código abierto que implementa una interfaz de línea de comandos sobre la API.As an alternative to calling the Microsoft Store submission API directly, we also provide an open-source PowerShell module which implements a command-line interface on top of the API. Este módulo se denomina StoreBroker.This module is called StoreBroker. Puede usar este módulo para administrar los envíos de aplicaciones, vuelos y complementos desde la línea de comandos en lugar de llamar directamente a la API de envío de Microsoft Store, o simplemente puede examinar el origen para ver más ejemplos de cómo llamar a esta API.You can use this module to manage your app, flight, and add-on submissions from the command line instead of calling the Microsoft Store submission API directly, or you can simply browse the source to see more examples for how to call this API. El módulo StoreBroker se usa activamente en Microsoft como la manera principal en que se envían a la tienda muchas aplicaciones propias.The StoreBroker module is actively used within Microsoft as the primary way that many first-party applications are submitted to the Store.

Para obtener más información, consulte nuestra Página de StoreBroker en github.For more information, see our StoreBroker page on GitHub.

Administrar un lanzamiento de paquete gradual para un envío de paquete pilotoManage a gradual package rollout for a package flight submission

Puedes lanzar gradualmente los paquetes actualizados de un envío de paquete piloto para un porcentaje de los clientes de tu aplicación en Windows 10.You can gradually roll out the updated packages in a package flight submission to a percentage of your app’s customers on Windows 10. Esto te permite supervisar los comentarios y los datos analíticos de los paquetes específicos para asegurarte de que estás seguro sobre la actualización antes de hacer un lanzamiento más amplio.This allows you to monitor feedback and analytic data for the specific packages to make sure you’re confident about the update before rolling it out more broadly. Puedes cambiar el porcentaje de lanzamiento (o detener la actualización) para un envío publicado sin tener que crear un nuevo envío.You can change the rollout percentage (or halt the update) for a published submission without having to create a new submission. Para obtener más información, incluidas las instrucciones para habilitar y administrar una implementación de paquetes gradual en el centro de Partners, consulte este artículo.For more details, including instructions for how to enable and manage a gradual package rollout in Partner Center, see this article.

Para habilitar mediante programación una implementación gradual de paquetes para el envío de paquetes piloto, siga este proceso mediante los métodos de la API de envío de Microsoft Store:To programmatically enable a gradual package rollout for a package flight submission, follow this process using methods in the Microsoft Store submission API:

  1. Crea un envío de paquete piloto u obtén un envío de paquete piloto.Create a package flight submission or get a package flight submission.
  2. En los datos de respuesta, busque el recurso packageRollout , establezca el campo isPackageRollout en true y establezca el campo packageRolloutPercentage en el porcentaje de los clientes de la aplicación que deben obtener los paquetes actualizados.In the response data, locate the packageRollout resource, set the isPackageRollout field to true, and set the packageRolloutPercentage field to the percentage of your app's customers who should get the updated packages.
  3. Pasa los datos de envío de paquete piloto actualizados al método de actualización de un envío de paquete piloto.Pass the updated package flight submission data to the update a package flight submission method.

Después de habilitar un lanzamiento de paquete gradual para un envío de paquete piloto, puedes usar los siguientes métodos para obtener, actualizar, detener o finalizar mediante programación el lanzamiento gradual.After a gradual package rollout is enabled for a package flight submission, you can use the following methods to programmatically get, update, halt, or finalize the gradual rollout.

MétodoMethod URIURI DescripciónDescription
GETGET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/packagerollout Obtener la información de lanzamiento gradual de un envío de paquete pilotoGet the gradual rollout info for a package flight submission
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/updatepackagerolloutpercentage Actualizar el porcentaje de lanzamiento gradual de un envío de paquete pilotoUpdate the gradual rollout percentage for a package flight submission
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/haltpackagerollout Detener el lanzamiento gradual de un envío de paquete pilotoHalt the gradual rollout for a package flight submission
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/finalizepackagerollout Finalizar el lanzamiento gradual de un envío de paquete pilotoFinalize the gradual rollout for a package flight submission

Recursos de datosData resources

Los métodos de la API de envío Microsoft Store para administrar los envíos de paquetes de vuelos usan los siguientes recursos de datos JSON.The Microsoft Store submission API methods for managing package flight submissions use the following JSON data resources.

Recursos de envío de paquete pilotoFlight submission resource

Este recurso describe un envío de paquete piloto.This resource describes a package flight submission.

{
  "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."
}

Este recurso tiene los siguientes valores.This resource has the following values.

ValueValue TipoType DescripciónDescription
idid stringstring Identificador del envío.The ID for the submission.
flightIdflightId stringstring Identificador del paquete piloto al que está asociado el envío.The ID of the package flight that the submission is associated with.
statusstatus stringstring Estado del envío.The status of the submission. Puede ser uno de los siguientes valores:This can be one of the following values:
  • NoneNone
  • CanceledCanceled
  • PendingCommitPendingCommit
  • CommitStartedCommitStarted
  • CommitFailedCommitFailed
  • PendingPublicationPendingPublication
  • PublicaciónPublishing
  • PublicadoPublished
  • PublishFailedPublishFailed
  • PreProcessingPreProcessing
  • PreProcessingFailedPreProcessingFailed
  • CertificaciónCertification
  • CertificationFailedCertificationFailed
  • ReleaseRelease
  • ReleaseFailedReleaseFailed
statusDetailsstatusDetails objectobject Un recurso de detalles de estado que contiene detalles adicionales sobre el estado del envío, incluida la información sobre los errores.A status details resource that contains additional details about the status of the submission, including information about any errors.
flightPackagesflightPackages arrayarray Contiene recursos de paquete piloto que proporcionan detalles acerca de cada paquete del envío.Contains flight package resources that provide details about each package in the submission.
packageDeliveryOptionspackageDeliveryOptions objectobject Un recurso de opciones de entrega de paquete que contiene el lanzamiento de paquete gradual y la configuración de actualización obligatoria para el envío.A package delivery options resource that contains gradual package rollout and mandatory update settings for the submission.
fileUploadUrlfileUploadUrl stringstring URI de firma de acceso compartido (SAS) para cargar los paquetes para el envío.The shared access signature (SAS) URI for uploading any packages for the submission. Si estás agregando nuevos paquetes para el envío, carga el archivo ZIP que contiene los paquetes en este URI.If you are adding new packages for the submission, upload the ZIP archive that contains the packages to this URI. Para obtener más información, consulta Crear un envío de paquete piloto.For more information, see Create a package flight submission.
targetPublishModetargetPublishMode stringstring Modo de publicación del envío.The publish mode for the submission. Puede ser uno de los siguientes valores:This can be one of the following values:
  • InmediataImmediate
  • ManualManual
  • SpecificDateSpecificDate
targetPublishDatetargetPublishDate stringstring Fecha de publicación del envío en formato ISO 8601, si el valor targetPublishMode se establece en SpecificDate.The publish date for the submission in ISO 8601 format, if the targetPublishMode is set to SpecificDate.
notesForCertificationnotesForCertification stringstring Proporciona información adicional de los evaluadores de certificación como, por ejemplo, las credenciales de la cuenta de prueba y los pasos para obtener acceso y comprobar las características.Provides additional info for the certification testers, such as test account credentials and steps to access and verify features. Para obtener más información, consulta Notas para la certificación.For more information, see Notes for certification.

Recurso de detalles de estadoStatus details resource

Este recurso contiene detalles adicionales sobre el estado de un envío.This resource contains additional details about the status of a submission. Este recurso tiene los siguientes valores.This resource has the following values.

ValueValue TipoType DescripciónDescription
errorserrors objectobject Una matriz de recursos de detalles de estado que contienen los detalles de errores del envío.An array of status detail resources that contain error details for the submission.
warningswarnings objectobject Una matriz de recursos de detalles de estado que contienen los detalles de advertencias del envío.An array of status detail resources that contain warning details for the submission.
certificationReportscertificationReports objectobject Una matriz de recursos de informe de certificación que proporcionan acceso a los datos del informe de certificación del envío.An array of certification report resources that provide access to the certification report data for the submission. Si se produce un error en la certificación, puedes examinar estos informes para obtener más información.You can examine these reports for more information if the certification fails.

Recurso de detalle de estadoStatus detail resource

Este recurso contiene información adicional acerca de las advertencias o los errores relacionados de un envío.This resource contains additional information about any related errors or warnings for a submission. Este recurso tiene los siguientes valores.This resource has the following values.

ValueValue TipoType DescripciónDescription
códigocode stringstring Un código de estado de envío que describe el tipo de error o advertencia.A submission status code that describes the type of error or warning.
detallesdetails stringstring Mensaje con más detalles sobre el problema.A message with more details about the issue.

Recurso de informe de certificaciónCertification report resource

Este recurso proporciona acceso a los datos del informe de certificación de un envío.This resource provides access to the certification report data for a submission. Este recurso tiene los siguientes valores.This resource has the following values.

ValueValue TipoType DescripciónDescription
datedate stringstring Fecha y hora en que se generó el informe, en formato ISO 8601.The date and time the report was generated, in ISO 8601 format.
reportUrlreportUrl stringstring Dirección URL en la que puedes obtener acceso al informe.The URL at which you can access the report.

Recurso de paquete pilotoFlight package resource

Este recurso proporciona detalles sobre un paquete en un envío.This resource provides details about a package in a submission.

{
  "flightPackages": [
    {
      "fileName": "newPackage.appx",
      "fileStatus": "PendingUpload",
      "id": "",
      "version": "1.0.0.0",
      "languages": ["en-us"],
      "capabilities": [],
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None"
    }
  ],
}

Este recurso tiene los siguientes valores.This resource has the following values.

Nota

Al llamar al método de envío actualizar un paquete piloto , solo se requieren los valores filename, fileStatus, minimumDirectXVersiony minimumSystemRam de este objeto en el cuerpo de la solicitud.When calling the update a package flight submission method, only the fileName, fileStatus, minimumDirectXVersion, and minimumSystemRam values of this object are required in the request body. Los demás valores se rellenan con el centro de Partners.The other values are populated by Partner Center.

ValueValue TipoType DescripciónDescription
fileNamefileName stringstring Nombre del paquete.The name of the package.
fileStatusfileStatus stringstring Estado del paquete.The status of the package. Puede ser uno de los siguientes valores:This can be one of the following values:
  • NoneNone
  • PendingUploadPendingUpload
  • CargadoUploaded
  • PendingDeletePendingDelete
idid stringstring Id. que identifica de manera exclusiva el paquete.An ID that uniquely identifies the package. Este valor lo utiliza el centro de Partners.This value is used by Partner Center.
versionversion stringstring Versión del paquete de aplicación.The version of the app package. Para obtener más información, consulta Numeración de la versión del paquete.For more information, see Package version numbering.
arquitecturaarchitecture stringstring Arquitectura del paquete de aplicación (por ejemplo, ARM).The architecture of the app package (for example, ARM).
languageslanguages arrayarray Matriz de códigos de idioma para los idiomas que admite la aplicación.An array of language codes for the languages the app supports. Para obtener más información, consulta Idiomas admitidos.For more information, see For more information, see Supported languages.
capabilitiescapabilities arrayarray Matriz de funcionalidades necesarias para el paquete.An array of capabilities required by the package. Para obtener más información acerca de las funcionalidades, consulta Declaraciones de funcionalidades de las aplicaciones.For more information about capabilities, see App capability declarations.
minimumDirectXVersionminimumDirectXVersion stringstring Versión mínima de DirectX que admite el paquete de aplicación.The minimum DirectX version that is supported by the app package. Solo se puede establecer para las aplicaciones diseñadas para Windows 8.x; se omite para las aplicaciones diseñadas para otras versiones.This can be set only for apps that target Windows 8.x; it is ignored for apps that target other versions. Puede ser uno de los siguientes valores:This can be one of the following values:
  • NoneNone
  • DirectX93DirectX93
  • DirectX100DirectX100
minimumSystemRamminimumSystemRam stringstring RAM mínima que requiere el paquete de aplicación.The minimum RAM that is required by the app package. Solo se puede establecer para las aplicaciones diseñadas para Windows 8.x; se omite para las aplicaciones diseñadas para otras versiones.This can be set only for apps that target Windows 8.x; it is ignored for apps that target other versions. Puede ser uno de los siguientes valores:This can be one of the following values:
  • NoneNone
  • Memory2GBMemory2GB

Recurso de opciones de entrega de paquetePackage delivery options resource

Este recurso contiene ajustes de lanzamiento de paquete gradual y de actualización obligatoria para el envío.This resource contains gradual package rollout and mandatory update settings for the submission.

{
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0.0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
}

Este recurso tiene los siguientes valores.This resource has the following values.

ValueValue TipoType DescripciónDescription
packageRolloutpackageRollout objectobject Un recurso de lanzamiento de paquete que contiene la configuración del lanzamiento de paquete gradual para el envío.A package rollout resource that contains gradual package rollout settings for the submission.
isMandatoryUpdateisMandatoryUpdate booleanboolean Indica si vas a tratar los paquetes de este envío como obligatorios para la instalación automática de actualizaciones de la aplicación.Indicates whether you want to treat the packages in this submission as mandatory for self-installing app updates. Para obtener más información sobre los paquetes obligatorios para la instalación automática de actualizaciones de la aplicación, consulta Descargar e instalar actualizaciones de paquete para tu aplicación.For more information about mandatory packages for self-installing app updates, see Download and install package updates for your app.
mandatoryUpdateEffectiveDatemandatoryUpdateEffectiveDate datedate La fecha y la hora en que los paquetes de este envío se convierten en obligatorios, en formato ISO 8601 y zona horaria UTC.The date and time when the packages in this submission become mandatory, in ISO 8601 format and UTC time zone.

Recurso de lanzamiento de paquetePackage rollout resource

Este recurso contiene la configuración de lanzamiento de paquete gradual para el envío.This resource contains gradual package rollout settings for the submission. Este recurso tiene los siguientes valores.This resource has the following values.

ValueValue TipoType DescripciónDescription
isPackageRolloutisPackageRollout booleanboolean Indica si el lanzamiento de paquete gradual está habilitado para el envío.Indicates whether gradual package rollout is enabled for the submission.
packageRolloutPercentagepackageRolloutPercentage FLOATfloat El porcentaje de usuarios que recibirá los paquetes en el lanzamiento gradual.The percentage of users who will receive the packages in the gradual rollout.
packageRolloutStatuspackageRolloutStatus stringstring Una de las siguientes cadenas, que indica el estado del lanzamiento de paquete gradual:One of the following strings that indicates the status of the gradual package rollout:
  • PackageRolloutNotStartedPackageRolloutNotStarted
  • PackageRolloutInProgressPackageRolloutInProgress
  • PackageRolloutCompletePackageRolloutComplete
  • PackageRolloutStoppedPackageRolloutStopped
fallbackSubmissionIdfallbackSubmissionId stringstring El identificador del envío que recibirán los clientes que no obtengan los paquetes de lanzamiento gradual.The ID of the submission that will be received by customers who do not get the gradual rollout packages.

Nota

Los valores packageRolloutStatus y fallbackSubmissionId se asignan por el centro de Partners y no están diseñados para que los establezca el desarrollador.The packageRolloutStatus and fallbackSubmissionId values are assigned by Partner Center, and are not intended to be set by the developer. Si incluye estos valores en un cuerpo de solicitud, estos valores se omitirán.If you include these values in a request body, these values will be ignored.

EnumeracionesEnums

Estos métodos usan las enumeraciones siguientes.These methods use the following enums.

Código de estado del envíoSubmission status code

Los siguientes códigos de representan el estado de un envío.The following codes represent the status of a submission.

CódigoCode DescripciónDescription
NoneNone No se especificó ningún código.No code was specified.
InvalidArchiveInvalidArchive El archivo ZIP que contiene el paquete no es válido o tiene un formato de archivo no reconocido.The ZIP archive containing the package is invalid or has an unrecognized archive format.
MissingFilesMissingFiles El archivo ZIP no tiene todos los archivos que se enumeran en los datos del envío o estos se encuentran en una ubicación incorrecta en el archivo.The ZIP archive does not have all files which were listed in your submission data, or they are in the wrong location in the archive.
PackageValidationFailedPackageValidationFailed Uno o varios paquetes de tu envío no se pudieron validar.One or more packages in your submission failed to validate.
InvalidParameterValueInvalidParameterValue Uno de los parámetros del cuerpo de la solicitud no es válido.One of the parameters in the request body is invalid.
InvalidOperationInvalidOperation La operación que intentaste realizar no es válida.The operation you attempted is invalid.
InvalidStateInvalidState La operación que intentaste realizar no es válida para el estado actual del paquete piloto.The operation you attempted is not valid for the current state of the package flight.
ResourceNotFoundResourceNotFound No se pudo encontrar el paquete piloto especificado.The specified package flight could not be found.
ServiceErrorServiceError Un error de servicio interno impidió que la solicitud se realizase correctamente.An internal service error prevented the request from succeeding. Vuelve a intentar realizar la solicitud.Try the request again.
ListingOptOutWarningListingOptOutWarning El desarrollador quitó una descripción de un envío anterior o no incluyó la información de descripción que admitía el paquete.The developer removed a listing from a previous submission, or did not include listing information that is supported by the package.
ListingOptInWarningListingOptInWarning El desarrollador agregó una lista.The developer added a listing.
UpdateOnlyWarningUpdateOnlyWarning El desarrollador está intentando insertar algo que solo presenta soporte técnico de actualizaciones.The developer is trying to insert something that only has update support.
OtrosOther El envío presenta un estado no reconocido o sin clasificar.The submission is in an unrecognized or uncategorized state.
PackageValidationWarningPackageValidationWarning El proceso de validación del paquete genera una advertencia.The package validation process resulted in a warning.