Partilhar via


Submeter uma proposta de voo de pacote

Use esse método na API de envio da Microsoft Store para confirmar um envio de voo 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 confirma 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 voo de pacote usando a API de envio da Microsoft Store, consulte Gerenciar envios de voo de pacote.

Pré-requisitos

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

Solicitação

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

Método Solicitar URI
Publicação 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
applicationId corda Obrigatório A ID da Loja do aplicativo que contém o envio de voo do pacote que você deseja confirmar. O ID da loja para a aplicação está disponível no Partner Center.
flightId corda Obrigatório O ID do voo do pacote que contém a submissão para confirmação. 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 O identificador da submissão a ser confirmado. Este ID está disponível nos dados de resposta para solicitações de criação de uma submissão 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.

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 confirmar um envio de voo de pacote.

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 de resposta JSON para uma chamada bem-sucedida para esse 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
Situação corda O estado da submissão. Este pode ser um dos seguintes valores:
  • Nenhum
  • Cancelado
  • CompromissoPendente
  • Início do Commit
  • FalhaNaConfirmação
  • Publicação Pendente
  • Publicação
  • Publicado
  • Falha na Publicação
  • Pré-processamento
  • Falha no Pré-processamento
  • Certificação
  • Falha na Certificação
  • Lançamento
  • Publicação Falhou

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
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 é suportado pela API de envio da Microsoft Store.