Atualizar um envio de aplicativoUpdate an app submission

Use este método na API de envio da Microsoft Store para atualizar um envio de aplicativo existente.Use this method in the Microsoft Store submission API to update an existing app submission. Depois de atualizar com êxito um envio usando esse método, você deverá confirmar o envio para ingestão e publicação.After you successfully update a submission by using this method, you must commit the submission for ingestion and publishing.

Para obter mais informações sobre como esse método se adapta ao processo de criação de um envio de app, usando a API de envio da Microsoft Store, consulte Gerenciar envios de aplicativo.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.

Pré-requisitosPrerequisites

Para usar este método, primeiro você precisa do seguinte:To use this method, you need to first do the following:

  • Se você não tiver feito isso, conclua todos os pré-requisitos para a API de envio da Microsoft Store.If you have not done so already, complete all the prerequisites for the Microsoft Store submission API.
  • Obtenha um token de acesso do Azure AD a ser usado no cabeçalho da solicitação para este método.Obtain an Azure AD access token to use in the request header for this method. Após obter um token de acesso, você tem 60 minutos para usá-lo antes dele expirar.After you obtain an access token, you have 60 minutes to use it before it expires. Depois que o token expirar, você poderá obter um novo.After the token expires, you can obtain a new one.
  • Crie um envio para um de seus aplicativos.Create a submission for one of your apps. Você pode fazer isso no Partner Center ou pode fazer isso usando o método criar um envio de aplicativo .You can do this in Partner Center, or you can do this by using the create an app submission method.

SolicitaçãoRequest

Esse método tem a seguinte sintaxe.This method has the following syntax. Veja as seções a seguir para obter exemplos de uso e descrições do corpo da solicitação e do cabeçalho.See the following sections for usage examples and descriptions of the header and request body.

MétodoMethod URI da solicitaçãoRequest URI
PUTPUT https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}

Cabeçalho da solicitaçãoRequest header

CabeçalhoHeader TipoType DescriçãoDescription
AutorizaçãoAuthorization stringstring Obrigatórios.Required. O token de acesso do Azure AD no formulário Bearer <token>.The Azure AD access token in the form Bearer <token>.

Parâmetros da solicitaçãoRequest parameters

NomeName TipoType DescriçãoDescription
applicationIdapplicationId stringstring Obrigatórios.Required. A ID da Loja do aplicativo para o qual você deseja atualizar um envio.The Store ID of the app for which you want to update a submission. Para saber mais informações sobre a ID da Loja, consulte Exibir detalhes de identidade de aplicativo.For more information about the Store ID, see View app identity details.
submissionIdsubmissionId stringstring Obrigatórios.Required. A ID do envio para atualizar.The ID of the submission to update. Esse ID está disponível nos dados de resposta para solicitações para criar um envio de aplicativo.This ID is available in the response data for requests to create an app submission. Para um envio criado no Partner Center, essa ID também está disponível na URL da página de envio no Partner Center.For a submission that was created in Partner Center, this ID is also available in the URL for the submission page in Partner Center.

Corpo da solicitaçãoRequest body

O corpo da solicitação tem os parâmetros a seguir.The request body has the following parameters.

ValorValue TipoType DescriçãoDescription
applicationCategoryapplicationCategory stringstring Uma cadeia de caracteres que especifica a categoria e/ou subcategoria para o aplicativo.A string that specifies the category and/or subcategory for your app. Categorias e subcategorias são combinadas em uma única cadeia de caracteres com o caractere de sublinhado '', como BooksAndReference_EReader.Categories and subcategories are combined into a single string with the underscore '' character, such as BooksAndReference_EReader.
preçospricing objetoobject Um objeto que contém informações de preços do aplicativo.An object that contains pricing info for the app. Para saber mais, veja a seção Preços de recurso.For more information, see the Pricing resource section.
visibilityvisibility stringstring A visibilidade do aplicativo.The visibility of the app. Esse valor pode ser um dos seguintes:This can be one of the following values:
  • HiddenHidden
  • PúblicoPublic
  • PrivadosPrivate
  • NotSetNotSet
targetPublishModetargetPublishMode stringstring O modo de publicação do envio.The publish mode for the submission. Esse valor pode ser um dos seguintes:This can be one of the following values:
  • ImediataImmediate
  • ManualManual
  • SpecificDateSpecificDate
targetPublishDatetargetPublishDate stringstring A data de publicação do envio em formato ISO 8601, se o targetPublishMode estiver definido como SpecificDate.The publish date for the submission in ISO 8601 format, if the targetPublishMode is set to SpecificDate.
listingslistings objetoobject Um dicionário de pares de chave e valor, no qual cada chave é um código de país e cada valor é um objeto recurso de listagem objeto que contém as informações de listagem do aplicativo.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 matrizarray Uma matriz de cadeias de caracteres que definem as preferências de hardware do aplicativo.An array of strings that define the hardware preferences for your app. Esse valor pode ser um dos seguintes:This can be one of the following values:
  • TouchTouch
  • TecladoKeyboard
  • MouseMouse
  • CâmeraCamera
  • NfcHceNfcHce
  • NfcNfc
  • BluetoothLEBluetoothLE
  • TelefoniaTelephony
automaticBackupEnabledautomaticBackupEnabled booleanoboolean Indica se o Windows pode incluir dados do aplicativo em backups automáticos no OneDrive.Indicates whether Windows can include your app's data in automatic backups to OneDrive. Para obter mais informações, consulte Declarações de aplicativo.For more information, see App declarations.
canInstallOnRemovableMediacanInstallOnRemovableMedia booleanoboolean Indica se os clientes podem instalar o aplicativo em armazenamento removível.Indicates whether customers can install your app to removable storage. Para obter mais informações, consulte Declarações de aplicativo.For more information, see App declarations.
isGameDvrEnabledisGameDvrEnabled booleanoboolean Indica se o DVR de jogos está habilitado para o aplicativo.Indicates whether game DVR is enabled for the app.
gamingOptionsgamingOptions objetoobject Uma matriz que contém um recurso de opções de jogo que define as configurações relacionadas a jogos para o app.An array that contains one gaming options resource that defines game-related settings for the app.
hasExternalInAppProductshasExternalInAppProducts booleanoboolean Indica se o aplicativo permite que os usuários façam compras fora do sistema de comércio da Microsoft Store.Indicates whether your app allows users to make purchase outside the Microsoft Store commerce system. Para obter mais informações, consulte Declarações de aplicativo.For more information, see App declarations.
meetAccessibilityGuidelinesmeetAccessibilityGuidelines booleanoboolean Indica se o aplicativo foi testado para atender às diretrizes de acessibilidade.Indicates whether your app has been tested to meet accessibility guidelines. Para obter mais informações, consulte Declarações de aplicativo.For more information, see App declarations.
notesForCertificationnotesForCertification stringstring Contém observações de certificação do aplicativo.Contains notes for certification for your app.
applicationPackagesapplicationPackages matrizarray Contém objetos que fornecem detalhes sobre cada pacote no envio.Contains objects that provide details about each package in the submission. Para saber mais, veja a seção Pacote de aplicativos.For more information, see the Application package section. Durante a chamada desse método para atualizar um envio de aplicativo, somente os valores fileName, fileStatus, minimumDirectXVersion e minimumSystemRam desses objetos são necessários no corpo da solicitação.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. Os outros valores são preenchidos pelo Partner Center.The other values are populated by Partner Center.
packageDeliveryOptionspackageDeliveryOptions objetoobject Contém as configurações de distribuição de pacote gradual e de atualização obrigatória para o envio.Contains gradual package rollout and mandatory update settings for the submission. Para obter mais informações, consulte Objeto de opções de entrega de pacote.For more information, see Package delivery options object.
enterpriseLicensingenterpriseLicensing stringstring Um dos valores de licenciamento empresarial que indicam o comportamento de licenciamento empresarial para o aplicativo.One of the enterprise licensing values values that indicate the enterprise licensing behavior for the app.
allowMicrosftDecideAppAvailabilityToFutureDeviceFamiliesallowMicrosftDecideAppAvailabilityToFutureDeviceFamilies booleanoboolean Indica se a Microsoft tem permissão para disponibilizar o aplicativo para as futuras famílias de dispositivos Windows 10.Indicates whether Microsoft is allowed to make the app available to future Windows 10 device families.
allowTargetFutureDeviceFamiliesallowTargetFutureDeviceFamilies booleanoboolean Indica se o aplicativo tem permissão para segmentar famílias de dispositivos Windows 10 futuras.Indicates whether your app is allowed to target future Windows 10 device families.
trailerstrailers matrizarray Uma matriz que contém até recursos de trailer que representam trailers de vídeo para a listagem de apps.An array that contains up to trailer resources that represent video trailers for the app listing.

Exemplo de solicitaçãoRequest example

O exemplo a seguir demonstra como atualizar um envio de aplicativo.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": []
}

RespostaResponse

O exemplo a seguir demonstra o corpo da resposta JSON para uma chamada bem-sucedida para esse método.The following example demonstrates the JSON response body for a successful call to this method. O corpo da resposta contém informações sobre o envio atualizado.The response body contains information about the updated submission. Para obter mais detalhes sobre os valores no corpo da resposta, veja Recurso do envio de aplicativo.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 do ErroError codes

Se não for possível concluir a solicitação, a resposta conterá um dos seguintes códigos de erro HTTP.If the request cannot be successfully completed, the response will contain one of the following HTTP error codes.

Código do erroError code DescriçãoDescription
400400 O envio não pôde ser atualizado porque a solicitação não é válida.The submission could not be updated because the request is invalid.
409409 O envio não pôde ser atualizado devido ao estado atual do aplicativo ou o aplicativo usa um recurso do centro de parceria que atualmente não tem suporte pela API de envio 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.