Actualización de un envío de aplicaciónUpdate an app submission

Use este método en la API de envío de Microsoft Store para actualizar un envío de aplicación existente.Use this method in the Microsoft Store submission API to update an existing app submission. Después de actualizar correctamente un envío mediante este método, debes confirmar el envío para su ingesta y publicación.After you successfully update a submission by using this method, you must 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 aplicación mediante el Microsoft Store API de envío, consulte Administración de envíos de aplicaciones.For more information about how this method fits into the process of creating an app submission by using the Microsoft Store submission API, see Manage app submissions.

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 envío para una de sus aplicaciones.Create a submission for one of your apps. Puede hacerlo en el centro de Partners o puede hacerlo mediante el método crear un envío de aplicación .You can do this in Partner Center, or you can do this by using the create an app submission 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
PUTPUT https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}

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 deseas actualizar un envío.The Store ID of the app for which you want to update a 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.
submissionIdsubmissionId stringstring Necesario.Required. Identificador del envío que se debe actualizar.The ID of the submission to update. Este identificador está disponible en los datos de respuesta para las solicitudes para crear un envío de aplicación.This ID is available in the response data for requests to create an app submission. En el caso de un envío creado en el centro de Partners, este identificador también está disponible en la dirección URL de la página de envío del centro de Partners.For a submission that was created in Partner Center, this ID is also available in the URL for the submission page in Partner Center.

Cuerpo de la solicitudRequest body

El cuerpo de la solicitud tiene los siguientes parámetros.The request body has the following parameters.

ValueValue TipoType DescripciónDescription
applicationCategoryapplicationCategory stringstring Cadena que especifica la categoría o subcategoría de la aplicación.A string that specifies the category and/or subcategory for your app. Las categorías y subcategorías se combinan en una cadena simple mediante el guion bajo "" como, por ejemplo, BooksAndReference_EReader.Categories and subcategories are combined into a single string with the underscore '' character, such as BooksAndReference_EReader.
Preciospricing objectobject Objeto que contiene la información del precio de la aplicación.An object that contains pricing info for the app. Para obtener más información, consulta la sección Recurso de precios.For more information, see the Pricing resource section.
visibilidadvisibility stringstring Visibilidad de la aplicación.The visibility of the app. Puede ser uno de los siguientes valores:This can be one of the following values:
  • HiddenHidden
  • PúblicoPublic
  • PrivadosPrivate
  • NotSetNotSet
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.
listingslistings objectobject Diccionario de pares de claves y valores en el cual cada clave hace referencia al código de un país y cada valor hace referencia a un objeto de recurso de descripción que contiene la descripción de la aplicación.A dictionary of key and value pairs, where each key is a country code and each value is a Listing resource object that contains listing info for the app.
hardwarePreferenceshardwarePreferences arrayarray Matriz de cadenas que definen las preferencias de hardware de la aplicación.An array of strings that define the hardware preferences for your app. Puede ser uno de los siguientes valores:This can be one of the following values:
  • TocarTouch
  • TecladoKeyboard
  • MouseMouse
  • CámaraCamera
  • NfcHceNfcHce
  • NfcNfc
  • BluetoothLEBluetoothLE
  • TelefoníaTelephony
automaticBackupEnabledautomaticBackupEnabled booleanboolean Indica si Windows puede incluir datos de la aplicación en copias de seguridad automáticas de OneDrive.Indicates whether Windows can include your app's data in automatic backups to OneDrive. Para obtener más información, consulta App declarations (Declaraciones de las aplicaciones).For more information, see App declarations.
canInstallOnRemovableMediacanInstallOnRemovableMedia booleanboolean Indica si los clientes pueden instalar la aplicación en el almacenamiento extraíble.Indicates whether customers can install your app to removable storage. Para obtener más información, consulta App declarations (Declaraciones de las aplicaciones).For more information, see App declarations.
isGameDvrEnabledisGameDvrEnabled booleanboolean Indica si se habilita game DVR en la aplicación.Indicates whether game DVR is enabled for the app.
gamingOptionsgamingOptions objectobject Una matriz que contiene un recurso de opciones de juego que define la configuración relacionada con el juego para la aplicación.An array that contains one gaming options resource that defines game-related settings for the app.
hasExternalInAppProductshasExternalInAppProducts booleanboolean Indica si la aplicación permite a los usuarios realizar compras fuera del sistema de comercio Microsoft Store.Indicates whether your app allows users to make purchase outside the Microsoft Store commerce system. Para obtener más información, consulta App declarations (Declaraciones de las aplicaciones).For more information, see App declarations.
meetAccessibilityGuidelinesmeetAccessibilityGuidelines booleanboolean Indica si la aplicación se ha probado para garantizar que cumple las directrices de accesibilidad.Indicates whether your app has been tested to meet accessibility guidelines. Para obtener más información, consulta App declarations (Declaraciones de las aplicaciones).For more information, see App declarations.
notesForCertificationnotesForCertification stringstring Contiene notas para la certificación de la aplicación.Contains notes for certification for your app.
applicationPackagesapplicationPackages arrayarray Contiene los objetos que proporcionan detalles acerca de cada paquete del envío.Contains objects that provide details about each package in the submission. Para obtener más información, consulta la sección Application package (Paquete de aplicación).For more information, see the Application package section. Al llamar a este método para actualizar un envío de aplicación, solo los valores fileName, fileStatus, minimumDirectXVersion y minimumSystemRam de esos objetos son necesarios en el cuerpo de la solicitud.When calling this method to update an app submission, only the fileName, fileStatus, minimumDirectXVersion, and minimumSystemRam values of these objects 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.
packageDeliveryOptionspackageDeliveryOptions objectobject Contiene el lanzamiento de paquete gradual y la configuración de actualización obligatoria del envío.Contains gradual package rollout and mandatory update settings for the submission. Para obtener más información, consulta Package delivery options object (Objeto de opciones de entrega de paquete).For more information, see Package delivery options object.
enterpriseLicensingenterpriseLicensing stringstring Uno de los valores de licencia de empresa indica el comportamiento de la licencia de empresa de la aplicación.One of the enterprise licensing values values that indicate the enterprise licensing behavior for the app.
allowMicrosftDecideAppAvailabilityToFutureDeviceFamiliesallowMicrosftDecideAppAvailabilityToFutureDeviceFamilies booleanboolean Indica si se permite que Microsoft tenga la aplicación disponible para futuras familias de dispositivos Windows 10.Indicates whether Microsoft is allowed to make the app available to future Windows 10 device families.
allowTargetFutureDeviceFamiliesallowTargetFutureDeviceFamilies booleanboolean Indica si se permite que la aplicación se enfoque a futuras familias de dispositivos Windows 10.Indicates whether your app is allowed to target future Windows 10 device families.
cliptrailers arrayarray Una matriz que contiene recursos hasta finalizador que representan finalizadores de vídeo para la lista de aplicaciones.An array that contains up to trailer resources that represent video trailers for the app listing.

Ejemplo de solicitudRequest example

En el siguiente ejemplo se muestra cómo actualizar un envío de aplicación.The following example demonstrates how to update an app submission.

PUT https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/submissions/1152921504621230023 HTTP/1.1
Authorization: Bearer <your access token>
Content-Type: application/json
{
  "applicationCategory": "BooksAndReference_EReader",
  "pricing": {
    "trialPeriod": "FifteenDays",
    "marketSpecificPricings": {},
    "sales": [],
    "priceId": "Tier2"
  },
  "visibility": "Public",
  "targetPublishMode": "Manual",
  "targetPublishDate": "1601-01-01T00:00:00Z",
  "listings": {
    "en-us": {
      "baseListing": {
        "copyrightAndTrademarkInfo": "",
        "keywords": [
              "epub"
            ],
        "licenseTerms": "",
        "privacyPolicy": "",
        "supportContact": "",
        "websiteUrl": "",
        "description": "Description",
        "features": [
              "Free ebook reader"
            ],
        "releaseNotes": "",
        "images": [
          {
            "fileName": "contoso.png",
            "fileStatus": "Uploaded",
            "id": "1152921504672272757",
            "imageType": "Screenshot"
          }
        ],
        "recommendedHardware": [],
        "title": "Contoso ebook reader"
      },
      "platformOverrides": {
        "Windows81": {
          "description": "Ebook reader for Windows 8.1"
        }
      }
    }
  },
  "hardwarePreferences": [
    "Touch"
  ],
  "automaticBackupEnabled": false,
  "canInstallOnRemovableMedia": true,
  "isGameDvrEnabled": false,
  "gamingOptions": [],
  "hasExternalInAppProducts": false,
  "meetAccessibilityGuidelines": true,
  "notesForCertification": "",
  "applicationPackages": [
    {
      "fileName": "contoso_app.appx",
      "fileStatus": "PendingUpload",
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None"
    }
  ],
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0.0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
  "enterpriseLicensing": "Online",
  "allowMicrosoftDecideAppAvailabilityToFutureDeviceFamilies": true,
  "allowTargetFutureDeviceFamilies": {
    "Desktop": false,
    "Mobile": true,
    "Holographic": true,
    "Xbox": false,
    "Team": true
  },
  "trailers": []
}

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 envío actualizado.The response body contains information about the updated submission. Para obtener más información acerca de los valores del cuerpo de la respuesta, consulta App submission resource (Recurso de envío de aplicación).For more details about the values in the response body, see App submission resource.

{
  "id": "1152921504621243540",
  "applicationCategory": "BooksAndReference_EReader",
  "pricing": {
    "trialPeriod": "FifteenDays",
    "marketSpecificPricings": {},
    "sales": [],
    "priceId": "Tier2"
  },
  "visibility": "Public",
  "targetPublishMode": "Manual",
  "targetPublishDate": "1601-01-01T00:00:00Z",
  "listings": {
    "en-us": {
      "baseListing": {
        "copyrightAndTrademarkInfo": "",
        "keywords": [
           "epub"
        ],
        "licenseTerms": "",
        "privacyPolicy": "",
        "supportContact": "",
        "websiteUrl": "",
        "description": "Description",
        "features": [
          "Free ebook reader"
        ],
        "releaseNotes": "",
        "images": [
          {
            "fileName": "contoso.png",
            "fileStatus": "Uploaded",
            "id": "1152921504672272757",
            "imageType": "Screenshot"
          }
        ],
        "recommendedHardware": [],
        "title": "Contoso ebook reader"
      },
      "platformOverrides": {
        "Windows81": {
          "description": "Ebook reader for Windows 8.1",
        }
      }
    }
  },
  "hardwarePreferences": [
    "Touch"
  ],
  "automaticBackupEnabled": false,
  "canInstallOnRemovableMedia": true,
  "isGameDvrEnabled": false,
  "gamingOptions": [],
  "hasExternalInAppProducts": false,
  "meetAccessibilityGuidelines": true,
  "notesForCertification": "",
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
  "fileUploadUrl": "https://productingestionbin1.blob.core.windows.net/ingestion/387a9ea8-a412-43a9-8fb3-a38d03eb483d?sv=2014-02-14&sr=b&sig=sdd12JmoaT6BhvC%2BZUrwRweA%2Fkvj%2BEBCY09C2SZZowg%3D&se=2016-06-17T18:32:26Z&sp=rwl",
  "applicationPackages": [
    {
      "fileName": "contoso_app.appx",
      "fileStatus": "PendingUpload",
      "id": "1152921504620138797",
      "version": "1.0.0.0",
      "architecture": "ARM",
      "languages": [
        "en-US"
      ],
      "capabilities": [
        "ID_RESOLUTION_HD720P",
        "ID_RESOLUTION_WVGA",
        "ID_RESOLUTION_WXGA"
      ],
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None",
      "targetDeviceFamilies": [
        "Windows.Mobile min version 10.0.10240.0"
      ]
    }
  ],
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0.0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
  "enterpriseLicensing": "Online",
  "allowMicrosoftDecideAppAvailabilityToFutureDeviceFamilies": true,
  "allowTargetFutureDeviceFamilies": {
    "Desktop": false,
    "Mobile": true,
    "Holographic": true,
    "Xbox": false,
    "Team": true
  },
  "friendlyName": "Submission 2",
  "trailers": []
}

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 actualizar el envío porque la solicitud no es válida.The submission could not be updated because the request is invalid.
409409 No se pudo actualizar el envío 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 submission could not be updated 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.