Realizar uma remessa de voo de pacote

2025-06-10

Use esse método na API de envio da Microsoft Store para confirmar um envio de pré-lançamento de pacote novo ou atualizado para o Partner Center. A ação de confirmação alerta o Partner Center de que os dados de envio foram carregados (incluindo quaisquer pacotes relacionados). Em resposta, o Partner Center compromete-se a aplicar as alterações nos dados de envio para ingestão e publicação. Depois que a operação de confirmação for bem-sucedida, as alterações no envio serão mostradas no Partner Center.

Para obter mais informações sobre como a operação de confirmação se encaixa no processo de criação de um envio de pacote de pré-lançamento usando a API de envio da Microsoft Store, consulte Gerenciar envios de pacote de pré-lançamento.

Pré-requisitos

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

Se você ainda não fez isso, conclua todos os pré-requisitos para a API de envio da Microsoft Store.
Obtenha um token de acesso do Azure AD a ser usado no cabeçalho da solicitação para esse método. Depois de obter um token de acesso, você terá 60 minutos para usá-lo antes que ele expire. Depois que o token expirar, você poderá obter um novo.
Criar um pacote de submissão piloto e depois atualizar a submissão com as alterações necessárias nos dados da submissão.

Solicitação

Esse método tem a sintaxe a seguir. Consulte as seções a seguir para obter exemplos de uso e descrições do corpo do cabeçalho e da solicitação.

Método	URI de solicitação
PUBLICAR	`https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/commit`

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
ID do aplicativo	corda	Obrigatório O ID da Loja do aplicativo que contém a submissão de pacote de voo que você deseja confirmar. O ID da Store para o aplicativo está disponível no Partner Center.
ID do voo	corda	Obrigatório O ID do pacote de envio que contém a submissão para commit. Este ID está disponível nos dados de resposta para solicitações para criar um voo de pacote e obter voos de pacote para um aplicativo. Para um voo criado no Partner Center, esse ID também está disponível na URL para a página de voo no Partner Center.
ID de submissão	corda	Obrigatório A ID do envio para confirmação. Essa ID está disponível nos dados de resposta para solicitações de criação de uma inscrição de pacote de pré-lançamento. Para um envio criado no Partner Center, essa ID também está disponível na URL para a página de envio no Partner Center.

Corpo da solicitação

Não forneça um corpo de solicitação para este método.

Exemplo de solicitação

O exemplo a seguir demonstra como confirmar um envio de pacote de pré-lançamento.

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

Resposta

O exemplo a seguir demonstra o corpo da resposta JSON de uma chamada bem-sucedida a este método. Para obter mais detalhes sobre os valores no corpo da resposta, consulte as seções a seguir.

{
  "status": "CommitStarted"
}

Corpo da resposta

Valor	Tipo	Descrição
estado	corda	A situação do envio. Esse valor pode ser um dos seguintes: Nenhum Cancelado CompromissoPendente Comprometimento Iniciado Falha na submissão Publicação Pendente Publicação Publicado Falha na publicação Pré-processamento Falha no pré-processamento Certificação Falha na certificação Liberação Falha no lançamento

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 do erro	Descrição
400	Os parâmetros de solicitação são inválidos.
404	Não foi possível encontrar a submissão especificada.
409	O envio especificado foi encontrado, mas não pôde ser confirmado em seu estado atual ou o aplicativo usa um recurso do Partner Center que atualmente não tem suporte da API de envio da Microsoft Store.

Compartilhar via