Actualización de un envío de aplicación

Artículo
07/05/2024

Usa este método en la API de envío de Microsoft Store para actualizar un envío de aplicación existente. Después de actualizar correctamente un envío mediante este método, debe confirmar 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 aplicación mediante la API de envío de Microsoft Store, consulta Administrar envíos de aplicaciones.

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 envío para una de las aplicaciones. Puede hacerlo en el Centro de partners o puede hacerlo mediante el método de creación de una aplicación de envío .

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 la solicitud
PUT	`https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}`

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 actualizar un envío. Para obtener más información sobre el identificador de la Tienda, consulta Ver los detalles de la identidad de la aplicación.
submissionId	string	Necesario. Identificador del envío que se va a actualizar. Este identificador está disponible en los datos de respuesta de las solicitudes para crear un envío de aplicación. Para 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 en el Centro de partners.

Cuerpo de la solicitud

El cuerpo de la solicitud tiene los parámetros siguientes.

Valor	Tipo	Descripción
applicationCategory	string	Cadena que especifica la categoría o subcategoría de la aplicación. Las categorías y subcategorías se combinan en una sola cadena con el carácter de subrayado "_", como BooksAndReference_EReader.
Precios	objeto	Objeto que contiene información de precios para la aplicación. Para obtener más información, consulte la sección Recurso de precios .
visibility	string	Visibilidad de la aplicación. Este puede ser uno de los siguientes valores: Oculto Público Privada NotSet
targetPublishMode	string	El modo de publicación para el envío. Este puede ser uno de los siguientes valores: Inmediato Manual SpecificDate
targetPublishDate	string	La fecha de publicación para el envío en formato ISO 8601, si targetPublishMode está establecido en SpecificDate.
listings	objeto	Diccionario de pares clave y valor, donde cada clave es un código de país y cada valor es un objeto de recurso Listing que contiene información de lista para la aplicación.
hardwarePreferences	array	Matriz de cadenas que definen las preferencias de hardware de la aplicación. Este puede ser uno de los siguientes valores: Tocar Teclado Mouse Camera NfcHce Nfc BluetoothLE Telefonía
automaticBackupEnabled	boolean	Indica si Windows puede incluir los datos de la aplicación en copias de seguridad automáticas en OneDrive. Para obtener más información, consulte Declaraciones de aplicaciones.
canInstallOnRemovableMedia	boolean	Indica si los clientes pueden instalar la aplicación en un almacenamiento extraíble. Para obtener más información, consulte Declaraciones de aplicaciones.
isGameDvrEnabled	boolean	Indica si el DVR del juego está habilitado para la aplicación.
gamingOptions	objeto	Matriz que contiene un recurso de opciones de juego que define la configuración relacionada con el juego para la aplicación.
hasExternalInAppProducts	boolean	Indica si la aplicación permite a los usuarios realizar compras fuera del sistema de comercio de Microsoft Store. Para obtener más información, consulte Declaraciones de aplicaciones.
meetAccessibilityGuidelines	boolean	Indica si la aplicación se ha probado para cumplir las directrices de accesibilidad. Para obtener más información, consulte Declaraciones de aplicaciones.
notesForCertification	string	Contiene notas para la certificación de la aplicación.
applicationPackages	array	Contiene objetos que proporcionan detalles sobre cada paquete del envío. Para obtener más información, consulte la sección Paquete de aplicación. Al llamar a este método para actualizar un envío de aplicación, solo se requieren los valores fileName, fileStatus, minimumDirectXVersion y minimumSystemRam de estos objetos en el cuerpo de la solicitud. Los demás valores se rellenan mediante el Centro de partners.
packageDeliveryOptions	objeto	Contiene la implementación gradual de paquetes y la configuración de actualización obligatoria para el envío. Para obtener más información, vea Package delivery options object (Objeto de opciones de entrega de paquetes).
enterpriseLicensing	string	Uno de los valores de licencia de empresa que indican el comportamiento de las licencias empresariales para la aplicación.
allowMicrosftDecideAppAvailabilityToFutureDeviceFamilies	boolean	Indica si Microsoft puede hacer que la aplicación esté disponible para futuras familias de dispositivos windows 10 y Windows 11.
allowTargetFutureDeviceFamilies	boolean	Indica si la aplicación puede tener como destino futuras familias de dispositivos Windows 10 y Windows 11.
remolques	array	Matriz que contiene hasta recursos de finalizador que representan finalizadores de vídeo para la lista de aplicaciones.

Ejemplo de solicitud

En el ejemplo siguiente se muestra cómo actualizar un envío de aplicación.

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": []
}

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 envío actualizado. Para obtener más información sobre los valores en el cuerpo de la respuesta, consulte Recurso de envío de aplicaciones.

{
  "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 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 actualizar el envío porque la solicitud no es válida.
409	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.

Compartir a través de

Actualización de un envío de aplicación

Requisitos previos

Solicitar

Encabezado de solicitud

Parámetros de solicitud

Cuerpo de la solicitud

Ejemplo de solicitud

Respuesta

Códigos de error

Comentarios

Recursos adicionales

Compartir a través de

Actualización de un envío de aplicación

Requisitos previos

Solicitar

Encabezado de solicitud

Parámetros de solicitud

Cuerpo de la solicitud

Ejemplo de solicitud

Respuesta

Códigos de error

Temas relacionados

Comentarios

Recursos adicionales