Finalizar a distribuição para um envio de versão de pré-lançamento

  • Artigo

Use esse método na API de envio da Microsoft Store a fim de finalizar a distribuição de pacote para o envio de um pacote de pré-lançamento. Para obter mais informações sobre o processo de criação de um envio de pacote de pré-lançamento usando a API de envio da Microsoft Store, consulte Gerenciar envios do pacote de pré-lançamento.

Pré-requisitos

Para usar este método, primeiro você precisa do seguinte:

Solicitação

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

Método URI da solicitação
POST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/finalizepackagerollout

Cabeçalho da solicitação

parâmetro Tipo Descrição
Autorização string Obrigatórios. O token de acesso Azure AD notoken> de portador< de formulário.

Parâmetros da solicitação

Nome Tipo Descrição
applicationId string Obrigatórios. A ID da Loja do aplicativo que contém o envio do pacote de pré-lançamento com a distribuição de pacote que você deseja finalizar. Para saber mais informações sobre a ID da Loja, consulte Exibir detalhes de identidade de aplicativo.
flightId string Obrigatórios. A ID do pacote de pré-lançamento que contém o envio com a distribuição de pacote que você deseja finalizar. Essa ID está disponível nos dados de resposta de solicitações para criar um pacote de pré-lançamento e obter pacotes de pré-lançamento para um aplicativo. Para um voo criado no Partner Center, essa ID também está disponível na URL da página de pré-lançamento no Partner Center.
submissionId string Obrigatórios. A ID do envio com a distribuição de pacote que você deseja finalizar. Esse ID está disponível nos dados de resposta para solicitações para criar um envio de pacote de pré-lançamento. Para um envio criado no Partner Center, essa ID também está disponível na URL da página de envio no Partner Center.

Corpo da solicitação

Não forneça um corpo da solicitação para esse método.

Exemplo de solicitação

O exemplo a seguir demonstra como finalizar a distribuição de pacote para um envio do pacote de pré-lançamento.

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

Resposta

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

{
    "isPackageRollout": true,
    "packageRolloutPercentage": 100.0,
    "packageRolloutStatus": "PackageRolloutComplete",
    "fallbackSubmissionId": "1212922684621243058"
}

Códigos do Erro

Se não for possível concluir a solicitação, a resposta conterá um dos seguintes códigos de erro HTTP.

Código do erro Descrição
404 O envio do pacote de pré-lançamento não foi encontrado.
409 Este código indica um dos seguintes erros: