Gerenciar envios de aplicativoManage app submissions

A API de envio da Microsoft Store oferece métodos que é possível usar para gerenciar envios dos aplicativos, inclusive distribuições de pacote graduais.The Microsoft Store submission API provides methods you can use to manage submissions for your apps, including gradual package rollouts. Para obter uma introdução à API de envio da Microsoft Store, inclusive pré-requisitos para usar a API, consulte Criar e gerenciar envios usando serviços da Microsoft Store.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

Se você usar a API de envio de Microsoft Store para criar um envio para um aplicativo, certifique-se de fazer outras alterações no envio somente usando a API, em vez do Partner Center.If you use the Microsoft Store submission API to create a submission for an app, be sure to make further changes to the submission only by using the API, rather than Partner Center. Se você usar o Partner Center para alterar um envio originalmente criado usando a API, não será mais possível alterar ou confirmar esse envio usando a API.If you use Partner Center 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. Em alguns casos, o envio pode ficar em um estado de erro em que ele não pode continuar no processo de envio.In some cases, the submission could be left in an error state where it cannot proceed in the submission process. Se isso ocorrer, você deve excluir o envio e criar um novo.If this occurs, you must delete the submission and create a new submission.

Importante

Você não pode usar essa API para publicar os envios de compras de volume por meio da Microsoft Store para Empresas e da Microsoft Store para Educação ou publicar os envios de aplicativos LOB diretamente para empresas.You cannot use this API to publish submissions for volume purchases through the Microsoft Store for Business and Microsoft Store for Education or to publish submissions for LOB apps directly to enterprises. Para ambos os cenários, você deve usar o Partner Center para publicar o envio.For both of these scenarios, you must use Partner Center to publish the submission.

Métodos para gerenciar envios de aplicativoMethods for managing app submissions

Use os métodos a seguir para obter, criar, atualizar, confirmar ou excluir um envio de app.Use the following methods to get, create, update, commit, or delete an app submission. Antes de poder usar esses métodos, o aplicativo já deve existir em sua conta do Partner Center e você deve primeiro criar um envio para o aplicativo no Partner Center.Before you can use these methods, the app must already exist in your Partner Center account and you must first create one submission for the app in Partner Center. Para obter mais informações, consulte os pré-requisitos.For more information, see the prerequisites.

MétodoMethod URIURI DescriçãoDescription
GETGET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId} Obter um envio de aplicativo existenteGet an existing app submission
GETGET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/status Obter o status de um envio de aplicativo existenteGet the status of an existing app submission
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions Criar um novo envio de aplicativoCreate a new app submission
PUTPUT https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId} Atualizar um envio de aplicativo existenteUpdate an existing app submission
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/commit Confirmar um envio de aplicativo novo ou atualizadoCommit a new or updated app submission
Delete (excluir)DELETE https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId} Excluir um envio de aplicativoDelete an app submission

Criar um envio de aplicativoCreate an app submission

Para criar um envio de um aplicativo, siga este processo.To create a submission for an app, follow this process.

  1. 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.

    Observação

    Verifique se o aplicativo já tem pelo menos um envio concluído com as informações de classificações etárias preenchidas.Make sure the app already has at least one completed submission with the age ratings information completed.

  2. Obtenha um token de acesso do Azure ad.Obtain an Azure AD access token. Você deve passar esse token de acesso aos métodos na API de envio da Microsoft Store.You must pass this access token to the methods in the Microsoft Store submission API. 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.

  3. Criar um envio de aplicativo executando o seguinte método na API de envio da Microsoft Store.Create an app submission by executing the following method in the Microsoft Store submission API. Esse método cria um novo envio em andamento, que é uma cópia de seu último envio 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}/submissions
    

    O corpo da resposta contém um recurso envio de complemento que inclui a ID do novo envio, o URI da SAS (assinatura de acesso compartilhado) para o upload de todos os arquivos relacionados para o envio para o armazenamento de Blobs do Azure (como pacotes de aplicativo, imagens de listagem e arquivos de trailer) e todos os dados do novo envio (como as listagens e as informações sobre preços).The response body contains an app submission resource that includes the ID of the new submission, the shared access signature (SAS) URI for uploading any related files for the submission to Azure Blob storage (such as app packages, listing images, and trailer files), and all of the data for the new submission (such as the listings and pricing information).

    Observação

    Um URI SAS dá acesso a um recurso seguro no armazenamento do Azure sem exigir chaves de conta.A SAS URI provides access to a secure resource in Azure storage without requiring account keys. Para obter informações contextuais sobre URIs SAS e o uso com o armazenamento do Blob do Azure, consulte Assinaturas de acesso compartilhado, parte 1: Noções básicas sobre o modelo SAS e Assinaturas de acesso compartilhado, parte 2: Criar e usar uma SAS com o armazenamento de Blob.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. Se você estiver adicionando novos pacotes, imagens de listagem ou arquivos de trailer para o envio, prepare os pacotes de aplicativo e prepare as imagens, os trailers e as capturas de tela do app.If you are adding new packages, listing images, or trailer files for the submission, prepare the app packages and prepare the app screenshots, images, and trailers. Adicione todos esses arquivos a um arquivo ZIP.Add all of these files to a ZIP archive.

  5. Revise os dados de envio de aplicativo com as alterações necessárias para o novo envio e execute o método a seguir para atualizar o envio de aplicativo.Revise the app submission data with any required changes for the new submission, and execute the following method to update the app submission.

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

    Observação

    Se você estiver adicionando novos arquivos para o envio, atualize os dados de envio para fazer referência ao nome e caminho relativo desses arquivos no arquivo ZIP.If you are adding new files 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. Se você estiver adicionando novos pacotes, imagens de listagem ou arquivos de trailer para o envio, carregue o arquivo ZIP no armazenamento do Blob do Azure usando o URI SAS que foi fornecido no corpo da resposta do método POST chamado anteriormente.If you are adding new packages, listing images, or trailer files 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. Existem bibliotecas do Azure diferentes que é possível usar para fazer isso em uma grande variedade de plataformas, inclusive:There are different Azure libraries you can use to do this on a variety of platforms, including:

    O exemplo de código em C# a seguir demonstra como carregar um arquivo ZIP no armazenamento do Blob do Azure usando a classe CloudBlockBlob na Biblioteca de Cliente do Armazenamento do Azure 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. Este exemplo pressupõe que o arquivo ZIP já tenha sido escrito para um objeto de fluxo.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. Confirme o envio de aplicativo executando o método a seguir.Commit the app submission by executing the following method. Isso alertará o Partner Center de que você concluiu seu envio e que suas atualizações agora devem ser aplicadas à sua conta.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}/submissions/{submissionId}/commit
    
  8. Verifique o status de confirmação executando o método a seguir para obter o status de envio de aplicativo.Check on the commit status by executing the following method to get the status of the app submission.

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

    Para confirmar o status de envio, examine o valor de status no corpo da resposta.To confirm the submission status, review the status value in the response body. Esse valor deve mudar de CommitStarted para PreProcessing se a solicitação for bem-sucedida ou CommitFailed se houver erros na solicitação.This value should change from CommitStarted to either PreProcessing if the request succeeds or to CommitFailed if there are errors in the request. Se houver erros, o campo statusDetails contém mais detalhes sobre o erro.If there are errors, the statusDetails field contains further details about the error.

  9. Após a confirmação ser concluída, o envio será enviado para a Loja para inclusão.After the commit has successfully completed, the submission is sent to the Store for ingestion. Você pode continuar a monitorar o progresso de envio usando o método anterior ou visitando o Partner Center.You can continue to monitor the submission progress by using the previous method, or by visiting Partner Center.

Métodos para gerenciar uma distribuição de pacote gradualMethods for managing a gradual package rollout

É possível distribuir gradualmente os pacotes atualizados em um envio de aplicativo para um percentual de clientes do aplicativo no Windows 10.You can gradually roll out the updated packages in an app submission to a percentage of your app’s customers on Windows 10. Isso permite que você monitore comentários e dados de análise dos pacotes específicos para verificar se a atualização é necessária antes de implantá-la mais amplamente.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. Você pode alterar a porcentagem de distribuição (ou parar a atualização) para um envio publicado sem precisar criar um novo envio.You can change the rollout percentage (or halt the update) for a published submission without having to create a new submission. Para obter mais detalhes, incluindo instruções sobre como habilitar e gerenciar uma distribuição gradual de pacotes no Partner Center, consulte Este artigo.For more details, including instructions for how to enable and manage a gradual package rollout in Partner Center, see this article.

Para habilitar programaticamente uma distribuição de pacote gradual para um envio de aplicativo, siga esse processo usando métodos na API de envio da Microsoft Store:To programmatically enable a gradual package rollout for an app submission, follow this process using methods in the Microsoft Store submission API:

  1. Crie um envio de aplicativo ou obtenha um envio de aplicativo existente.Create an app submission or get an existing app submission.
  2. Nos dados de resposta, localize o recurso packageRollout, defina o campo isPackageRollout como true e o campo packageRolloutPercentage como o percentual de clientes do aplicativo que devem receber os pacotes atualizados.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. Passe os dados de envio de aplicativo atualizados para o método atualizar um envio de aplicativo.Pass the updated app submission data to the update an app submission method.

Depois que uma distribuição de pacote gradual for habilitada para um envio de aplicativo, será possível usar os métodos a seguir para obter, atualizar, interromper ou finalizar programaticamente a distribuição gradual.After a gradual package rollout is enabled for an app submission, you can use the following methods to programmatically get, update, halt, or finalize the gradual rollout.

MétodoMethod URIURI DescriçãoDescription
GETGET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/packagerollout Obter as informações de distribuição gradual para um envio de aplicativoGet the gradual rollout info for an app submission
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/updatepackagerolloutpercentage Atualizar o percentual de distribuição gradual para um envio de aplicativoUpdate the gradual rollout percentage for an app submission
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/haltpackagerollout Interromper a distribuição gradual para um envio de aplicativoHalt the gradual rollout for an app submission
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/finalizepackagerollout Finalizar a distribuição gradual para um envio de aplicativoFinalize the gradual rollout for an app submission

Exemplos de código para gerenciar envios de aplicativoCode examples for managing app submissions

Os artigos a seguir apresentam exemplos detalhados de código que demonstram como criar um envio de aplicativo em diversas linguagens de programação diferentes:The following articles provide detailed code examples that demonstrate how to create an app submission in several different programming languages:

Módulo StoreBroker do PowerShellStoreBroker PowerShell module

Como uma alternativa à chamada direta à API de envio da Microsoft Store, nós também fornecemos um módulo do PowerShell de software livre que implementa uma interface de linha de comando sobre 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. Esse módulo é chamado StoreBroker.This module is called StoreBroker. Você pode usar esse módulo para gerenciar seu app, versão de pré-lançamento e envios de complemento na linha de comando em vez de chamar diretamente a API de envio da Microsoft Store, ou você pode simplesmente procurar a fonte para ver mais exemplos de como chamar essa 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. O módulo StoreBroker ativamente é usado dentro da Microsoft como a principal forma de muitos apps de terceiros serem enviados para a Store.The StoreBroker module is actively used within Microsoft as the primary way that many first-party applications are submitted to the Store.

Para obter mais informações, consulte nossa Página do StoreBroker no GitHub.For more information, see our StoreBroker page on GitHub.

Recursos de dadosData resources

Os métodos da API de envio da Microsoft Store para gerenciar envios de aplicativo usam os recursos de dados JSON a seguir.The Microsoft Store submission API methods for managing app submissions use the following JSON data resources.

Recurso de envio de aplicativoApp submission resource

Esse recurso descreve um envio de aplicativo.This resource describes an app submission.

{
  "id": "1152921504621243540",
  "applicationCategory": "BooksAndReference_EReader",
  "pricing": {
    "trialPeriod": "FifteenDays",
    "marketSpecificPricings": {},
    "sales": [],
    "priceId": "Tier2",
    "isAdvancedPricingModel": true
  },
  "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",
            "description": "Main page",
            "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": "Uploaded",
      "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": []
}

Esse recurso tem os valores a seguir.This resource has the following values.

ValorValue TipoType DescriçãoDescription
idid stringstring A ID do envio.The ID of the submission. Essa ID está disponível nos dados de resposta para solicitações para criar um envio de aplicativo, obter todos os apps e obter um app.This ID is available in the response data for requests to create an app submission, get all apps, and get an app. 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.
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 recurso de preço que contém informações de preço para o aplicativo.A pricing resource that contains pricing info for the app.
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, em que cada chave é um código de país e cada valor é um recurso de listagem que contém 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 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 matrizarray 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.
statusstatus stringstring O status do envio.The status of the submission. Esse valor pode ser um dos seguintes:This can be one of the following values:
  • NãoNone
  • CanceledCanceled
  • PendingCommitPendingCommit
  • CommitStartedCommitStarted
  • CommitFailedCommitFailed
  • PendingPublicationPendingPublication
  • PublicandoPublishing
  • PublicadoPublished
  • PublishFailedPublishFailed
  • PreProcessingPreProcessing
  • PreProcessingFailedPreProcessingFailed
  • CertificaçãoCertification
  • CertificationFailedCertificationFailed
  • VersãoRelease
  • ReleaseFailedReleaseFailed
statusDetailsstatusDetails objetoobject Um recurso de detalhes do status que contém detalhes adicionais sobre o status do envio, inclusive informações sobre eventuais erros.A status details resource that contains additional details about the status of the submission, including information about any errors.
fileUploadUrlfileUploadUrl stringstring O URI da assinatura de acesso compartilhado (SAS) para carregar todos os pacotes para o envio.The shared access signature (SAS) URI for uploading any packages for the submission. Se você estiver adicionando novos pacotes, imagens de listagem ou arquivos de trailer para o envio, carregue o arquivo ZIP que contém os pacotes e imagens para este URI.If you are adding new packages, listing images, or trailer files for the submission, upload the ZIP archive that contains the packages and images to this URI. Para obter mais informações, consulte Criar um envio de aplicativo.For more information, see Create an app submission.
applicationPackagesapplicationPackages matrizarray Uma matriz de recursos do pacote de aplicativos que dão detalhes sobre cada pacote no envio.An array of application package resources that provide details about each package in the submission.
packageDeliveryOptionspackageDeliveryOptions objetoobject Um recurso de opções de entrega do pacote que contém configurações da distribuição de pacote gradual e da atualização obrigatória para o envio.A package delivery options resource that contains gradual package rollout and mandatory update settings for the submission.
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.
allowMicrosoftDecideAppAvailabilityToFutureDeviceFamiliesallowMicrosoftDecideAppAvailabilityToFutureDeviceFamilies 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 objetoobject Um dicionário de pares de chave e valor, onde cada chave é uma família de dispositivos Windows 10 e cada valor é um valor booliano que indica se seu aplicativo tem permissão para segmentar a família de dispositivos especificadas.A dictionary of key and value pairs, where each key is a Windows 10 device family and each value is a boolean that indicates whether your app is allowed to target the specified device family.
friendlyNamefriendlyName stringstring O nome amigável do envio, conforme mostrado no Partner Center.The friendly name of the submission, as shown in Partner Center. Esse valor é gerado para você ao criar o envio.This value is generated for you when you create the submission.
trailerstrailers matrizarray Uma matriz que contém até 15 recursos de trailer que representam trailers de vídeo para a listagem de apps.An array that contains up to 15 trailer resources that represent video trailers for the app listing.

Recurso de preçoPricing resource

Esse recurso contém informações de preço do aplicativo.This resource contains pricing info for the app. Esse recurso tem os valores a seguir.This resource has the following values.

ValorValue TipoType DescriçãoDescription
trialPeriodtrialPeriod stringstring Uma cadeia de caracteres que especifica o período de avaliação do aplicativo.A string that specifies the trial period for the app. Esse valor pode ser um dos seguintes:This can be one of the following values:
  • NoFreeTrialNoFreeTrial
  • OneDayOneDay
  • TrialNeverExpiresTrialNeverExpires
  • SevenDaysSevenDays
  • FifteenDaysFifteenDays
  • ThirtyDaysThirtyDays
marketSpecificPricingsmarketSpecificPricings objetoobject Um dicionário de pares de chave e valor, onde cada chave é um código ISO 3166-1 alpha-2 de duas letras do país e cada valor é uma faixa de preço.A dictionary of key and value pairs, where each key is a two-letter ISO 3166-1 alpha-2 country code and each value is a price tier. Esses itens representam os preços personalizados do aplicativo em mercados específicos.These items represent the custom prices for your app in specific markets. Todos os itens nesse dicionário substituem o preço base especificado pelo valor priceId para o mercado especificado.Any items in this dictionary override the base price specified by the priceId value for the specified market.
vendassales matrizarray Preterido.Deprecated. Uma matriz de recursos de venda que contêm informações de venda do aplicativo.An array of sale resources that contain sales information for the app.
priceIdpriceId stringstring A faixa de preço que especifica o preço base do app.A price tier that specifies the base price for the app.
isAdvancedPricingModelisAdvancedPricingModel booleanoboolean Se for true, sua conta de desenvolvedor tem acesso ao conjunto expandido de faixas de preço de US$ 0,99 a US$ 1999,99.If true, your developer account has access to the expanded set of price tiers from .99 USD to 1999.99 USD. Se for true, sua conta de desenvolvedor tem acesso ao conjunto original de faixas de preço de US$ 0,99 a US$ 999,99.If false, your developer account has access to the original set of price tiers from .99 USD to 999.99 USD. Para saber mais sobre as diferentes camadas, consulte faixas de preço.For more information about the different tiers, see price tiers.

Note   Observação   Este campo é somente leitura.Note  This field is read-only.

Recurso de vendaSale resource

Esse recurso contém informações de venda de um aplicativo.This resources contains sale info for an app.

Importante

O recurso Venda não tem mais suporte, e atualmente você não pode acessar nem modificar os dados de venda de um envio de aplicativo usando a API de envio da Microsoft Store.The Sale resource is no longer supported, and currently you cannot get or modify the sale data for an app submission using the Microsoft Store submission API. No futuro, atualizaremos a API de envio da Microsoft Store para apresentar uma nova maneira de acessar programaticamente as informações de vendas para envios de aplicativo.In the future, we will update the Microsoft Store submission API to introduce a new way to programmatically access sales information for app submissions.

Esse recurso tem os valores a seguir.This resource has the following values.

ValorValue TipoType DescriçãoDescription
namename stringstring O nome da promoção.The name of the sale.
basePriceIdbasePriceId stringstring A faixa de preço a ser usada para o preço base da promoção.The price tier to use for the base price of the sale.
startDatestartDate stringstring A data de início da promoção no formato ISO 8601.The start date for the sale in ISO 8601 format.
endDateendDate stringstring A data de término da promoção no formato ISO 8601.The end date for the sale in ISO 8601 format.
marketSpecificPricingsmarketSpecificPricings objetoobject Um dicionário de pares de chave e valor, onde cada chave é um código ISO 3166-1 alpha-2 de duas letras do país e cada valor é uma faixa de preço.A dictionary of key and value pairs, where each key is a two-letter ISO 3166-1 alpha-2 country code and each value is a price tier. Esses itens representam os preços personalizados do aplicativo em mercados específicos.These items represent the custom prices for your app in specific markets. Todos os itens nesse dicionário substituem o preço base especificado pelo valor basePriceId para o mercado especificado.Any items in this dictionary override the base price specified by the basePriceId value for the specified market.

Recurso de listagemListing resource

Esse recurso contém informações de listagem de um aplicativo.This resource contains listing info for an app. Esse recurso tem os valores a seguir.This resource has the following values.

ValorValue TipoType DescriçãoDescription
baseListingbaseListing objetoobject As informações de listagem básica do aplicativo, que definem o padrão de informações de listagem para todas as plataformas.The base listing info for the app, which defines the default listing info for all platforms.
platformOverridesplatformOverrides objetoobject Um dicionário de pares de chave e valor, em que cada chave é a cadeia de caracteres que identifica uma plataforma cujas informações de listagem devem ser substituídas e cada valor é um recurso de listagem básica (contendo apenas os valores da descrição ao título) que especifica as informações de listagem a serem substituídas para a plataforma especificada.A dictionary of key and value pairs, where each key is string that identifies a platform for which to override the listing info, and each value is a base listing resource (containing only the values from description to title) that specifies the listing info to override for the specified platform. As chaves podem ter os seguintes valores:The keys can have the following values:
  • UnknownUnknown
  • Windows80Windows80
  • Windows81Windows81
  • WindowsPhone71WindowsPhone71
  • WindowsPhone80WindowsPhone80
  • WindowsPhone81WindowsPhone81

Recurso de listagem baseBase listing resource

Esse recurso contém informações de listagem base de um aplicativo.This resource contains base listing info for an app. Esse recurso tem os valores a seguir.This resource has the following values.

ValorValue TipoType DescriçãoDescription
copyrightAndTrademarkInfocopyrightAndTrademarkInfo stringstring Informações opcionais de direitos autorais e/ou marca comercial.Optional copyright and/or trademark info.
palavras-chavekeywords matrizarray Uma matriz de palavra-chave para ajudar seu aplicativo a aparecer nos resultados de pesquisa.An array of keyword to help your app appear in search results.
licenseTermslicenseTerms stringstring Os termos de licença opcionais do seu aplicativo.The optional license terms for your app.
privacyPolicyprivacyPolicy stringstring Esse valor está obsoleto.This value is obsolete. Para definir ou alterar a URL da política de privacidade para seu aplicativo, você deve fazer isso na página de Propriedades no Partner Center.To set or change the privacy policy URL for your app, you must do this on the Properties page in Partner Center. Você pode omitir esse valor de suas chamadas para a API de envio.You can omit this value from your calls to the submission API. Se você definir esse valor, ele será ignorado.If you set this value, it will be ignored.
supportContactsupportContact stringstring Esse valor está obsoleto.This value is obsolete. Para definir ou alterar a URL de contato de suporte ou endereço de email para seu aplicativo, você deve fazer isso na página de Propriedades no Partner Center.To set or change the support contact URL or email address for your app, you must do this on the Properties page in Partner Center. Você pode omitir esse valor de suas chamadas para a API de envio.You can omit this value from your calls to the submission API. Se você definir esse valor, ele será ignorado.If you set this value, it will be ignored.
websiteUrlwebsiteUrl stringstring Esse valor está obsoleto.This value is obsolete. Para definir ou alterar a URL da página da Web para seu aplicativo, você deve fazer isso na página de Propriedades no Partner Center.To set or change the URL of the web page for your app, you must do this on the Properties page in Partner Center. Você pode omitir esse valor de suas chamadas para a API de envio.You can omit this value from your calls to the submission API. Se você definir esse valor, ele será ignorado.If you set this value, it will be ignored.
descriçãodescription stringstring A descrição dos detalhes do aplicativo.The description for the app listing.
recursosfeatures matrizarray Uma matriz de até 20 cadeias de caracteres que lista os recursos do seu aplicativo.An array of up to 20 strings that list the features for your app.
releaseNotesreleaseNotes stringstring As notas de versão do aplicativo.The release notes for your app.
imagesimages matrizarray Uma matriz de recursos de imagem e ícone para a listagem do aplicativo.An array of image and icon resources for the app listing.
recommendedHardwarerecommendedHardware matrizarray Uma matriz de até 11 cadeias de caracteres que lista as configurações de hardware recomendadas para o aplicativo.An array of up to 11 strings that list the recommended hardware configurations for your app.
minimumHardwareminimumHardware stringstring Uma matriz de até 11 cadeias de caracteres que lista as configurações de hardware mínimas para o app.An array of up to 11 strings that list the minimum hardware configurations for your app.
títulotitle stringstring O título da listagem do aplicativo.The title for the app listing.
shortDescriptionshortDescription stringstring Usado somente para jogos.Only used for games. Essa descrição é exibida na seção Informações do Hub de Jogos no Xbox One e ajuda os clientes a entender mais sobre o seu jogo.This description appears in the Information section of the Game Hub on Xbox One, and helps customers understand more about your game.
shortTitleshortTitle stringstring Uma versão mais curta do nome do seu produto.A shorter version of your product’s name. Se fornecido, esse nome mais curto pode aparecer em vários lugares no Xbox One (durante a instalação, em Conquistas etc.) no lugar do título completo do seu produto.If provided, this shorter name may appear in various places on Xbox One (during installation, in Achievements, etc.) in place of the full title of your product.
sortTitlesortTitle stringstring Se seu produto puder ser colocado em ordem alfabética de maneiras diferentes, você poderá inserir outra versão aqui.If your product could be alphabetized in different ways, you can enter another version here. Isso pode ajudar os clientes a encontrar o produto mais rapidamente ao pesquisar.This may help customers find the product more quickly when searching.
voiceTitlevoiceTitle stringstring Um nome alternativo para seu produto que, se fornecido, pode ser usado na experiência de áudio no Xbox One ao usar o Kinect ou um headset.An alternate name for your product that, if provided, may be used in the audio experience on Xbox One when using Kinect or a headset.
devStudiodevStudio stringstring Especifica esse valor se você quiser incluir um campo Desenvolvido por na listagem.Specify this value if you want to include a Developed by field in the listing. (O campo Publicado por listará o nome de exibição do publicador associado à conta, independentemente de você fornecer ou não um valor para o campo devStudio).(The Published by field will list the publisher display name associated with your account, whether or not you provide a devStudio value.)

Recurso de imagemImage resource

Esse recurso contém dados de imagem e ícone para uma listagem do aplicativo.This resource contains image and icon data for an app listing. Para obter mais informações sobre imagens e ícones para uma listagem de app, consulte Capturas de tela e imagens do app.For more information about images and icons for an app listing, see App screenshots and images. Esse recurso tem os valores a seguir.This resource has the following values.

ValorValue TipoType DescriçãoDescription
fileNamefileName stringstring O nome do arquivo de imagem no arquivo ZIP que você carregou para o envio.The name of the image file in the ZIP archive that you uploaded for the submission.
fileStatusfileStatus stringstring O status do arquivo de imagem.The status of the image file. Esse valor pode ser um dos seguintes:This can be one of the following values:
  • NãoNone
  • PendingUploadPendingUpload
  • CarregadoUploaded
  • PendingDeletePendingDelete
idid stringstring A ID da imagem.The ID for the image. Esse valor é fornecido pelo Partner Center.This value is supplied by Partner Center.
descriçãodescription stringstring A descrição da imagem.The description for the image.
imageTypeimageType stringstring Indica o tipo da imagem.Indicates the type of the image. Há suporte para as seguintes cadeias de caracteres.The following strings are currently supported.

Imagens de captura de tela:Screenshot images:

  • Captura de tela (use esse valor para a captura de tela da área de trabalho)Screenshot (use this value for the desktop screenshot)
  • MobileScreenshotMobileScreenshot
  • XboxScreenshotXboxScreenshot
  • SurfaceHubScreenshotSurfaceHubScreenshot
  • HoloLensScreenshotHoloLensScreenshot

Logotipos da loja:Store logos:

  • StoreLogo9x16StoreLogo9x16
  • StoreLogoSquareStoreLogoSquare
  • Ícone (use esse valor para o logotipo 1:1 de 300 x 300 pixels)Icon (use this value for the 1:1 300 x 300 pixels logo)

Imagens promocionais:Promotional images:

  • PromotionalArt16x9PromotionalArt16x9
  • PromotionalArtwork2400X1200PromotionalArtwork2400X1200

Imagens do Xbox:Xbox images:

  • XboxBrandedKeyArtXboxBrandedKeyArt
  • XboxTitledHeroArtXboxTitledHeroArt
  • XboxFeaturedPromotionalArtXboxFeaturedPromotionalArt

Imagens promocionais opcionais:Optional promotional images:

  • SquareIcon358X358SquareIcon358X358
  • BackgroundImage1000X800BackgroundImage1000X800
  • PromotionalArtwork414X180PromotionalArtwork414X180

Recurso de opções de jogoGaming options resource

Esse recurso contém configurações relacionadas a jogo para o app.This resource contains game-related settings for the app. Os valores neste recurso correspondem às configurações de jogo para envios no Partner Center.The values in this resource correspond to the game settings for submissions in Partner Center.

{
  "gamingOptions": [
    {
      "genres": [
        "Games_ActionAndAdventure",
        "Games_Casino"
      ],
      "isLocalMultiplayer": true,
      "isLocalCooperative": true,
      "isOnlineMultiplayer": false,
      "isOnlineCooperative": false,
      "localMultiplayerMinPlayers": 2,
      "localMultiplayerMaxPlayers": 12,
      "localCooperativeMinPlayers": 2,
      "localCooperativeMaxPlayers": 12,
      "isBroadcastingPrivilegeGranted": true,
      "isCrossPlayEnabled": false,
      "kinectDataForExternal": "Enabled"
    }
  ],
}

Esse recurso tem os valores a seguir.This resource has the following values.

ValorValue TipoType DescriçãoDescription
gênerosgenres matrizarray Uma matriz de uma ou mais das seguintes cadeias de caracteres que descrevem os gêneros do jogo:An array of one or more of the following strings that describe the genres of the game:
  • Games_ActionAndAdventureGames_ActionAndAdventure
  • Games_CardAndBoardGames_CardAndBoard
  • Games_CasinoGames_Casino
  • Games_EducationalGames_Educational
  • Games_FamilyAndKidsGames_FamilyAndKids
  • Games_FightingGames_Fighting
  • Games_MusicGames_Music
  • Games_PlatformerGames_Platformer
  • Games_PuzzleAndTriviaGames_PuzzleAndTrivia
  • Games_RacingAndFlyingGames_RacingAndFlying
  • Games_RolePlayingGames_RolePlaying
  • Games_ShooterGames_Shooter
  • Games_SimulationGames_Simulation
  • Games_SportsGames_Sports
  • Games_StrategyGames_Strategy
  • Games_WordGames_Word
isLocalMultiplayerisLocalMultiplayer booleanoboolean Indica se o jogo dá suporte a multijogador local.Indicates whether the game supports local multiplayer.
isLocalCooperativeisLocalCooperative booleanoboolean Indica se o jogo dá suporte a cooperação local.Indicates whether the game supports local co-op.
isOnlineMultiplayerisOnlineMultiplayer booleanoboolean Indica se o jogo dá suporte a multijogador online.Indicates whether the game supports online multiplayer.
isOnlineCooperativeisOnlineCooperative booleanoboolean Indica se o jogo dá suporte a cooperação online.Indicates whether the game supports online co-op.
localMultiplayerMinPlayerslocalMultiplayerMinPlayers INTint Especifica o número mínimo de jogadores a que o jogo dá suporte para multijogador local.Specifies the minimum number of players the game supports for local multiplayer.
localMultiplayerMaxPlayerslocalMultiplayerMaxPlayers INTint Especifica o número máximo de jogadores a que o jogo dá suporte para multijogador local.Specifies the maximum number of players the game supports for local multiplayer.
localCooperativeMinPlayerslocalCooperativeMinPlayers INTint Especifica o número mínimo de jogadores a que o jogo dá suporte para cooperação local.Specifies the minimum number of players the game supports for local co-op.
localCooperativeMaxPlayerslocalCooperativeMaxPlayers INTint Especifica o número máximo de jogadores a que o jogo dá suporte para cooperação local.Specifies the maximum number of players the game supports for local co-op.
isBroadcastingPrivilegeGrantedisBroadcastingPrivilegeGranted booleanoboolean Indica se o jogo dá suporte a difusão.Indicates whether the game supports broadcasting.
isCrossPlayEnabledisCrossPlayEnabled booleanoboolean Indica se o jogo oferece suporte a sessões multijogador entre jogadores no Xbox e em computadores Windows 10.Indicates whether the game supports multiplayer sessions between players on Windows 10 PCs and Xbox.
kinectDataForExternalkinectDataForExternal stringstring Um dos seguintes valores de cadeia de caracteres que indica se o jogo pode coletar dados do Kinect e enviá-los a serviços externos:One of the following string values that indicates whether the game can collect Kinect data and send it to external services:
  • NotSetNotSet
  • UnknownUnknown
  • HabilitadaEnabled
  • DesabilitadoDisabled

Observação

O recurso gamingOptions foi adicionado em maio de 2017, depois que a API de envio da Microsoft Store foi lançada pela primeira vez para desenvolvedores.The gamingOptions resource was added in May 2017, after the Microsoft Store submission API was first released to developers. Se você tiver criado um envio para um app por meio da API de envio antes da introdução desse recurso e se esse envio ainda estiver em andamento, esse recurso será nulo para envios para o app até que você confirme com êxito o envio ou o exclua.If you created a submission for an app via the submission API before this resource was introduced and this submission is still in progress, this resource will be null for submissions for the app until you successfully commit the submission or you delete it. Se o recurso gamingOptions não estiver disponível para envios para um app, o campo hasAdvancedListingPermission do recurso Application retornado pelo método obter um app será falso.If the gamingOptions resource is not available for submissions for an app, the hasAdvancedListingPermission field of the Application resource returned by the get an app method is false.

Recurso de detalhes do statusStatus details resource

Esse recurso contém detalhes adicionais sobre o status de um envio.This resource contains additional details about the status of a submission. Esse recurso tem os valores a seguir.This resource has the following values.

ValorValue TipoType DescriçãoDescription
erroserrors objetoobject Uma matriz de recursos de detalhes do status que contêm detalhes do erro para o envio.An array of status detail resources that contain error details for the submission.
warningswarnings objetoobject Uma matriz de recursos de detalhes do status que contêm detalhes do aviso para o envio.An array of status detail resources that contain warning details for the submission.
certificationReportscertificationReports objetoobject Uma matriz de recursos do relatório de certificação que dão acesso aos dados do relatório de certificação para o envio.An array of certification report resources that provide access to the certification report data for the submission. Será possível examinar esses relatórios para obter mais informações, se a certificação falhar.You can examine these reports for more information if the certification fails.

Recurso de detalhes do statusStatus detail resource

Esse recurso contém informações adicionais sobre todos os erros ou avisos relacionados a um envio.This resource contains additional information about any related errors or warnings for a submission. Esse recurso tem os valores a seguir.This resource has the following values.

ValorValue TipoType DescriçãoDescription
codecode stringstring Um código de status do envio que descreve o tipo de erro ou aviso.A submission status code that describes the type of error or warning.
detalhesdetails stringstring Uma mensagem com mais detalhes sobre o problema.A message with more details about the issue.

Recurso do pacote de aplicativosApplication package resource

Esse recurso contém detalhes sobre um pacote de aplicativos para o envio.This resource contains details about an app package for the submission.

{
  "applicationPackages": [
    {
      "fileName": "contoso_app.appx",
      "fileStatus": "Uploaded",
      "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"
      ]
    }
  ],
}

Esse recurso tem os valores a seguir.This resource has the following values.

Observação

Durante a chamada do método atualizar um envio de aplicativo, somente os valores fileName, fileStatus, minimumDirectXVersion, e minimumSystemRam desse objeto são necessários no corpo da solicitação.When calling the update an app submission method, only the fileName, fileStatus, minimumDirectXVersion, and minimumSystemRam values of this object are required in the request body. Os outros valores são preenchidos pelo Partner Center.The other values are populated by Partner Center.

ValorValue TipoType DescriçãoDescription
fileNamefileName stringstring O nome do pacote.The name of the package.
fileStatusfileStatus stringstring O status do pacote.The status of the package. Esse valor pode ser um dos seguintes:This can be one of the following values:
  • NãoNone
  • PendingUploadPendingUpload
  • CarregadoUploaded
  • PendingDeletePendingDelete
idid stringstring Uma ID que identifica exclusivamente o pacote.An ID that uniquely identifies the package. Esse valor é fornecido pelo Partner Center.This value is provided by Partner Center.
versionversion stringstring A versão do pacote do aplicativo.The version of the app package. Para obter mais informações, consulte Numeração de versão do pacote.For more information, see Package version numbering.
Arquiteturaarchitecture stringstring A arquitetura do pacote (por exemplo, ARM).The architecture of the package (for example, ARM).
idiomaslanguages matrizarray Uma matriz de códigos de idioma para os idiomas com suporte do aplicativo.An array of language codes for the languages the app supports. Para obter mais informações, consulte Linguagens com suporte.For more information, see Supported languages.
funcionalidadescapabilities matrizarray Uma matriz de recursos necessários pelo pacote.An array of capabilities required by the package. Para obter mais informações sobre recursos, consulte Declarações de recursos de aplicativos.For more information about capabilities, see App capability declarations.
minimumDirectXVersionminimumDirectXVersion stringstring A versão mínima do DirectX que é compatível com o pacote do aplicativo.The minimum DirectX version that is supported by the app package. Isso pode ser definido apenas para apps destinados ao Windows 8.x.This can be set only for apps that target Windows 8.x. Para aplicativos destinados a outras versões do sistema operacional, esse valor deve estar presente ao chamar o método atualizar um envio de aplicativo, mas o valor especificado será ignorado.For apps that target other OS versions, this value must be present when calling the update an app submission method but the value you specify is ignored. Esse valor pode ser um dos seguintes:This can be one of the following values:
  • NãoNone
  • DirectX93DirectX93
  • DirectX100DirectX100
minimumSystemRamminimumSystemRam stringstring A RAM mínima necessária para o pacote do aplicativo.The minimum RAM that is required by the app package. Isso pode ser definido apenas para apps destinados ao Windows 8.x.This can be set only for apps that target Windows 8.x. Para aplicativos destinados a outras versões do sistema operacional, esse valor deve estar presente ao chamar o método atualizar um envio de aplicativo, mas o valor especificado será ignorado.For apps that target other OS versions, this value must be present when calling the update an app submission method but the value you specify is ignored. Esse valor pode ser um dos seguintes:This can be one of the following values:
  • NãoNone
  • Memory2GBMemory2GB
targetDeviceFamiliestargetDeviceFamilies matrizarray Uma matriz de cadeias de caracteres que representam as famílias de dispositivos que o pacote segmenta.An array of strings that represent the device families that the package targets. Esse valor é usado somente para pacotes destinados ao Windows 10; para pacotes destinados a versões anteriores, esse valor tem o valor Nenhum.This value is used only for packages that target Windows 10; for packages that target earlier releases, this value has the value None. As seguintes cadeias de caracteres da família de dispositivos têm suporte atualmente para pacotes do Windows 10, em que {0} é uma cadeia de caracteres de versão do Windows 10, como 10.0.10240.0, 10.0.10586.0 ou 10.0.14393.0:The following device family strings are currently supported for Windows 10 packages, where {0} is a Windows 10 version string such as 10.0.10240.0, 10.0.10586.0 or 10.0.14393.0:
  • Windows. versão mínima universal {0}Windows.Universal min version {0}
  • Versão mínima do Windows. desktop {0}Windows.Desktop min version {0}
  • Versão mínima do Windows. Mobile {0}Windows.Mobile min version {0}
  • Versão Mín do Windows. Xbox {0}Windows.Xbox min version {0}
  • Versão mínima do Windows. Holographic {0}Windows.Holographic min version {0}

Recurso do relatório de certificaçãoCertification report resource

Esse recurso dá acesso aos dados do relatório de certificação para um envio.This resource provides access to the certification report data for a submission. Esse recurso tem os valores a seguir.This resource has the following values.

ValorValue TipoType DescriçãoDescription
datedate stringstring A data e a hora em que o relatório foi gerado, no formato ISO 8601.The date and time the report was generated, in ISO 8601 format.
reportUrlreportUrl stringstring A URL na qual é possível acessar o relatório.The URL at which you can access the report.

Recurso de opções de entrega do pacotePackage delivery options resource

Esse recurso contém configurações da distribuição de pacote gradual e da atualização obrigatória para o envio.This resource contains gradual package rollout and mandatory update settings for the submission.

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

Esse recurso tem os valores a seguir.This resource has the following values.

ValorValue TipoType DescriçãoDescription
packageRolloutpackageRollout objetoobject Um recurso de distribuição de pacote que contém configurações da distribuição de pacote gradual para o envio.A package rollout resource that contains gradual package rollout settings for the submission.
isMandatoryUpdateisMandatoryUpdate booleanoboolean Indica se você deseja tratar os pacotes nesse envio como obrigatórios para instalar automaticamente atualizações de aplicativo.Indicates whether you want to treat the packages in this submission as mandatory for self-installing app updates. Para obter mais informações sobre pacotes obrigatórios para instalar automaticamente as atualizações de aplicativos, consulte Baixar e instalar atualizações de pacote para seu app.For more information about mandatory packages for self-installing app updates, see Download and install package updates for your app.
mandatoryUpdateEffectiveDatemandatoryUpdateEffectiveDate datedate A data e hora em que os pacotes nesse envio se tornam obrigatórios, em formato ISO 8601 e fuso horário UTC.The date and time when the packages in this submission become mandatory, in ISO 8601 format and UTC time zone.

Recurso de distribuição de pacotePackage rollout resource

Esse recurso contém configurações de distribuição de pacote gradual para o envio.This resource contains gradual package rollout settings for the submission. Esse recurso tem os valores a seguir.This resource has the following values.

ValorValue TipoType DescriçãoDescription
isPackageRolloutisPackageRollout booleanoboolean Indica se a distribuição de pacote gradual está habilitada para o envio.Indicates whether gradual package rollout is enabled for the submission.
packageRolloutPercentagepackageRolloutPercentage FLOATfloat O percentual de usuários que receberão os pacotes na distribuição gradual.The percentage of users who will receive the packages in the gradual rollout.
packageRolloutStatuspackageRolloutStatus stringstring Uma das seguintes sequências que indicam o status da distribuição de pacote gradual:One of the following strings that indicates the status of the gradual package rollout:
  • PackageRolloutNotStartedPackageRolloutNotStarted
  • PackageRolloutInProgressPackageRolloutInProgress
  • PackageRolloutCompletePackageRolloutComplete
  • PackageRolloutStoppedPackageRolloutStopped
fallbackSubmissionIdfallbackSubmissionId stringstring A ID da submissão que será recebido por clientes que não recebem os pacotes de lançamento gradual.The ID of the submission that will be received by customers who do not get the gradual rollout packages.

Observação

Os valores packageRolloutStatus e fallbackSubmissionId são atribuídos pelo Partner Center e não devem ser definidos pelo desenvolvedor.The packageRolloutStatus and fallbackSubmissionId values are assigned by Partner Center, and are not intended to be set by the developer. Se você incluir esses valores no corpo da solicitação, esses valores serão ignorados.If you include these values in a request body, these values will be ignored.

Recurso de trailersTrailers resource

Esse recurso representa um trailer de vídeo para a listagem do app.This resource represents a video trailer for the app listing. Os valores neste recurso correspondem às opções de trailers para envios no Partner Center.The values in this resource correspond to the trailers options for submissions in Partner Center.

Você pode adicionar até 15 recursos de trailer à matriz trailers em um recurso de envio de aplicativo.You can add up to 15 trailer resources to the trailers array in an app submission resource. Para carregar arquivos de vídeo do trailer e imagens em miniatura para um envio, adicione esses arquivos ao mesmo arquivo ZIP que contém os pacotes e as imagens de listagem para o envio e então carregue esse arquivo ZIP no URI da SAS (assinatura de acesso compartilhado) do envio.To upload trailer video files and thumbnail images for a submission, add these files to the same ZIP archive that contains the packages and listing images for the submission, and then upload this ZIP archive to the shared access signature (SAS) URI for the submission. Para obter mais informações sobre o upload do arquivo ZIP no URI da SAS, consulte Criar um envio de aplicativo.For more information uploading the ZIP archive to the SAS URI, see Create an app submission.

{
  "trailers": [
    {
      "id": "1158943556954955699",
      "videoFileName": "Trailers\\ContosoGameTrailer.mp4",
      "videoFileId": "1159761554639123258",
      "trailerAssets": {
        "en-us": {
          "title": "Contoso Game",
          "imageList": [
            {
              "fileName": "Images\\ContosoGame-Thumbnail.png",
              "id": "1155546904097346923",
              "description": "This is a still image from the video."
            }
          ]
        }
      }
    }
  ]
}

Esse recurso tem os valores a seguir.This resource has the following values.

ValorValue TipoType DescriçãoDescription
idid stringstring A ID do trailer.The ID for the trailer. Esse valor é fornecido pelo Partner Center.This value is provided by Partner Center.
videoFileNamevideoFileName stringstring O nome do arquivo de vídeo de trailer no arquivo ZIP que contém arquivos para o envio.The name of the trailer video file in the ZIP archive that contains files for the submission.
videoFileIdvideoFileId stringstring A ID do arquivo de vídeo de trailer.The ID for the trailer video file. Esse valor é fornecido pelo Partner Center.This value is provided by Partner Center.
trailerAssetstrailerAssets objetoobject Um dicionário de pares de chave e valor, onde cada chave é um código de idioma e cada valor é um recurso de ativos de trailer que contém outros ativos específicos da localidade para o trailer.A dictionary of key and value pairs, where each key is a language code and each value is a trailer assets resource that contains additional locale-specific assets for the trailer. Para saber mais sobre os códigos de idioma com suporte, consulte Idiomas com suporte.For more information about the supported language codes, see Supported languages.

Observação

O recurso trailers foi adicionado em maio de 2017, depois que a API de envio da Microsoft Store foi lançada pela primeira vez para desenvolvedores.The trailers resource was added in May 2017, after the Microsoft Store submission API was first released to developers. Se você tiver criado um envio para um app por meio da API de envio antes da introdução desse recurso e se esse envio ainda estiver em andamento, esse recurso será nulo para envios para o app até que você confirme com êxito o envio ou o exclua.If you created a submission for an app via the submission API before this resource was introduced and this submission is still in progress, this resource will be null for submissions for the app until you successfully commit the submission or you delete it. Se o recurso trailers não estiver disponível para envios para um app, o campo hasAdvancedListingPermission do recurso Application retornado pelo método obter um app será falso.If the trailers resource is not available for submissions for an app, the hasAdvancedListingPermission field of the Application resource returned by the get an app method is false.

Recurso de ativos de trailerTrailer assets resource

Esse recurso contém outros ativos específicos da localidade para um trailer definido em um recurso de trailer.This resource contains additional locale-specific assets for a trailer that is defined in a trailer resource. Esse recurso tem os valores a seguir.This resource has the following values.

ValorValue TipoType DescriçãoDescription
títulotitle stringstring O título localizado do trailer.The localized title of the trailer. O título é exibido quando o usuário reproduz o trailer em modo de tela inteira.The title is displayed when the user plays the trailer in full screen mode.
imageListimageList matrizarray Uma matriz que contém um recurso de imagem que fornece a imagem em miniatura do trailer.An array that contains one image resource that provides the thumbnail image for the trailer. Você só pode incluir um recurso de imagem nessa matriz.You can only include one image resource in this array.

Recurso de imagem (para um trailer)Image resource (for a trailer)

Esse recurso descreve a imagem em miniatura para um trailer.This resource describes the thumbnail image for a trailer. Esse recurso tem os valores a seguir.This resource has the following values.

ValorValue TipoType DescriçãoDescription
fileNamefileName stringstring O nome do arquivo de imagem em miniatura no arquivo ZIP que você carregou para o envio.The name of the thumbnail image file in the ZIP archive that you uploaded for the submission.
idid stringstring A ID da imagem em miniatura.The ID for the thumbnail image. Esse valor é fornecido pelo Partner Center.This value is provided by Partner Center.
descriçãodescription stringstring A descrição da imagem em miniatura.The description for the thumbnail image. Esse valor é composto somente por metadados e não é exibido para os usuários.This value is metadata only, and is not displayed to users.

EnumeraçõesEnums

Esses métodos usam as enumerações a seguir.These methods use the following enums.

Faixas de preçoPrice tiers

Os seguintes valores representam as faixas de preço disponíveis no recurso preço do recurso para um envio de app.The following values represent available price tiers in the pricing resource resource for an app submission.

ValorValue DescriçãoDescription
BaseBase A faixa de preço não está definida. Use o preço base para o aplicativo.The price tier is not set; use the base price for the app.
NotAvailableNotAvailable O aplicativo não está disponível na região especificada.The app is not available in the specified region.
GratuitaFree O aplicativo é gratuito.The app is free.
Faixa dexxxxTierxxx Uma cadeia de caracteres que especifica a faixa de preço do app, no formato Faixaxxxx.A string that specifies the price tier for the app, in the format Tierxxxx. No momento, há suporte para os seguintes intervalos de faixas de preço:Currently, the following ranges of price tiers are supported:

  • Se o valor isAdvancedPricingModel do preço do recurso for true, os valores de nível de preço disponíveis para sua conta são Tier1012 - Tier1424.If the isAdvancedPricingModel value of the pricing resource is true, the available price tier values for your account are Tier1012 - Tier1424.
  • Se o valor isAdvancedPricingModel do preço do recurso for false, os valores de nível de preço disponíveis para sua conta são Tier2 - Tier96.If the isAdvancedPricingModel value of the pricing resource is false, the available price tier values for your account are Tier2 - Tier96.
Para ver a tabela completa de camadas de preço que estão disponíveis para sua conta de desenvolvedor, incluindo os preços específicos do mercado associados a cada camada, acesse a página de preços e disponibilidade de qualquer envio de aplicativo no Partner Center e clique no link Exibir tabela na seção mercados e preços personalizados (para algumas contas de desenvolvedor, esse link está na seção de preços ).To see the complete table of price tiers that are available for your developer account, including the market-specific prices that are associated with each tier, go to the Pricing and availability page for any of your app submissions in Partner Center and click the view table link in the Markets and custom prices section (for some developer accounts, this link is in the Pricing section).

Valores de licenciamento da empresaEnterprise licensing values

Os seguintes valores representam o comportamento de licenciamento organizacional do app.The following values represent the organizational licensing behavior for the app. Para obter mais informações sobre essas opções, consulte Opções de licenciamento organizacional.For more information about these options, see Organizational licensing options.

Observação

Embora você possa configurar as opções de licenciamento organizacional para um envio de aplicativo por meio da API de envio, você não pode usar essa API para publicar os envios de compras de volume por meio da Microsoft Store para Empresas e da Microsoft Store para Educação.Although you can configure the organizational licensing options for an app submission via the submission API, you cannot use this API to publish submissions for volume purchases through the Microsoft Store for Business and Microsoft Store for Education. Para publicar os envios no Microsoft Store for Business e Microsoft Store for Education, você deve usar o Partner Center.To publish submissions to the Microsoft Store for Business and Microsoft Store for Education, you must use Partner Center.

ValorValue DescriçãoDescription
NenhumNone Não disponibilize seu aplicativo para empresas com licenciamento por volume gerenciado pela Loja (online).Do not make your app available to enterprises with Store-managed (online) volume licensing.
OnlineOnline Disponibilize seu aplicativo para empresas com licenciamento por volume gerenciado pela Loja (online).Make your app available to enterprises with Store-managed (online) volume licensing.
OnlineAndOfflineOnlineAndOffline Disponibilize seu aplicativo para as empresas com licenciamento por volume gerenciado pela Loja (online) e disponibilize seu aplicativo a empresas por meio de licenciamento desconectado (offline).Make your app available to enterprises with Store-managed (online) volume licensing, and make your app available to enterprises via disconnected (offline) licensing.

Código de status do envioSubmission status code

Os seguintes valores representam o código de status de um envio.The following values represent the status code of a submission.

ValorValue DescriçãoDescription
NenhumNone Nenhum código foi especificado.No code was specified.
InvalidArchiveInvalidArchive O arquivo ZIP que contém o pacote não é válido ou tem um formato de arquivo não reconhecido.The ZIP archive containing the package is invalid or has an unrecognized archive format.
MissingFilesMissingFiles O arquivo ZIP não tem todos os arquivos que foram listados nos seus dados de envio ou estão no local errado no arquivo.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 Falha ao validar um ou mais pacotes no seu envio.One or more packages in your submission failed to validate.
InvalidParameterValueInvalidParameterValue Um dos parâmetros no corpo da solicitação não é válido.One of the parameters in the request body is invalid.
InvalidOperationInvalidOperation A operação tentada não é válida.The operation you attempted is invalid.
InvalidStateInvalidState A operação tentada não é válida para o estado atual do pacote de pré-lançamento.The operation you attempted is not valid for the current state of the package flight.
ResourceNotFoundResourceNotFound O pacote de pré-lançamento especificado não foi encontrado.The specified package flight could not be found.
ServiceErrorServiceError Um erro de serviço interno impediu o êxito da solicitação.An internal service error prevented the request from succeeding. Repita a solicitação.Try the request again.
ListingOptOutWarningListingOptOutWarning O desenvolvedor removeu uma listagem de um envio anterior ou não incluiu informações de listagem que são compatíveis com o pacote.The developer removed a listing from a previous submission, or did not include listing information that is supported by the package.
ListingOptInWarningListingOptInWarning O desenvolvedor adicionou uma listagem.The developer added a listing.
UpdateOnlyWarningUpdateOnlyWarning O desenvolvedor está tentando inserir algo que só tem suporte para a atualização.The developer is trying to insert something that only has update support.
OutroOther O envio está em um estado não reconhecido ou não categorizado.The submission is in an unrecognized or uncategorized state.
PackageValidationWarningPackageValidationWarning O processo de validação do pacote resultou em um aviso.The package validation process resulted in a warning.