Atualizar a percentagem de implementação para uma submissão de voo

2025-04-30

Use esse método na API de envio da Microsoft Store para atualizar a porcentagem de distribuição para um envio de voo de pacote. Para obter mais informações sobre o processo de criação de um envio de voo de pacote usando a API de envio de voo da Microsoft Store, consulte Gerenciar envios de voo de pacote.

Pré-requisitos

Para usar esse método, você precisa primeiro fazer o seguinte:

Se você ainda não tiver feito isso, preencha todos os pré-requisitos para a API de envio da Microsoft Store.
Obtenha um token de acesso do Azure AD para usar no cabeçalho da solicitação para esse método. Depois de obter um token de acesso, você tem 60 minutos para usá-lo antes que ele expire. Depois que o token expirar, você poderá obter um novo.
Faça uma submissão para uma das suas aplicações. Você pode fazer isso no Partner Center ou pode fazer isso usando o método de criar uma submissão de aplicativo.
Configure um lançamento progressivo do pacote para a submissão. Você pode fazer isso no Partner Center ou usando a API de envio da Microsoft Store.

Solicitação

Este método tem a seguinte sintaxe. Consulte as seções a seguir para obter exemplos de uso e descrições dos parâmetros de cabeçalho e solicitação.

Método	Solicitar URI
Publicação	`https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/updatepackagerolloutpercentage`

Cabeçalho da solicitação

Cabeçalho	Tipo	Descrição
Autorização	corda	Obrigatório O token de acesso do Azure AD no formato Bearer<token>.

Parâmetros de solicitação

Nome	Tipo	Descrição
applicationId	corda	Obrigatório A ID da Loja do aplicativo que contém o envio de voo do pacote com a porcentagem de distribuição do pacote que você deseja atualizar. Para obter mais informações sobre a ID da Loja, consulte Exibir detalhes da identidade do aplicativo.
flightId	corda	Obrigatório O identificador do pacote de voo que contém o envio com a percentagem de distribuição do pacote que pretendes atualizar. Esse ID está disponível nos dados de resposta para solicitações para criar um pacote de voo e obter voos de pacote para um aplicativo. Para um voo criado no Partner Center, esse ID também está disponível no URL da página do voo no Partner Center.
ID da submissão	corda	Obrigatório A ID do envio com a porcentagem de distribuição do pacote que você deseja atualizar. Esse ID está disponível nos dados de resposta para solicitações para criar um envio de voo de pacote. Para um envio criado no Partner Center, esse ID também está disponível no URL da página de envio no Partner Center.
percentagem	flutuante	Obrigatório A porcentagem de usuários que receberão o pacote de distribuição gradual.

Corpo de solicitação

Não forneça um conteúdo de solicitação para este método.

Exemplo de solicitação

O exemplo a seguir demonstra como atualizar a porcentagem de distribuição de pacotes para um envio de voo de pacote.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243680/updatepackagerolloutpercentage?percentage=25 HTTP/1.1
Authorization: Bearer <your access token>

Resposta

O exemplo a seguir demonstra o corpo de resposta JSON para uma chamada bem-sucedida para esse método. Para obter mais detalhes sobre os valores no corpo da resposta, consulte o recurso de distribuição de pacotes .

{
    "isPackageRollout": true,
    "packageRolloutPercentage": 25.0,
    "packageRolloutStatus": "PackageRolloutInProgress",
    "fallbackSubmissionId": "1212922684621243058"
}

Códigos de erro

Se a solicitação não puder ser concluída com êxito, a resposta conterá um dos seguintes códigos de erro HTTP.

Código de erro	Descrição
404	Não foi possível encontrar a submissão referente ao voo do pacote.
409	Este código indica um dos seguintes erros: O envio não está em um estado válido para a operação de distribuição gradual (antes de chamar esse método, o envio deve ser publicado e o valor packageRolloutStatus deve ser definido como PackageRolloutInProgress). O envio não pertence ao aplicativo especificado. O aplicativo usa um recurso do Partner Center que atualmente não é suportado pela API de envio da Microsoft Store.

Código de erro

Descrição

404

Não foi possível encontrar a submissão referente ao voo do pacote.

409

Este código indica um dos seguintes erros:

O envio não está em um estado válido para a operação de distribuição gradual (antes de chamar esse método, o envio deve ser publicado e o valor packageRolloutStatus deve ser definido como PackageRolloutInProgress).
O envio não pertence ao aplicativo especificado.
O aplicativo usa um recurso do Partner Center que atualmente não é suportado pela API de envio da Microsoft Store.