Partilhar via


Confirmar um envio de aplicativo

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

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.
  • Crie um envio de aplicativo e, em seguida, atualize o envio com quaisquer alterações necessárias nos dados de envio.

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}/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 O ID da loja da app que contém a submissão que pretende confirmar. Para obter mais informações sobre a ID da Loja, consulte Exibir detalhes da identidade do aplicativo.
ID da submissão corda Obrigatório A ID do envio que você deseja confirmar. Este ID está disponível nos dados de resposta para pedidos para criar uma submissão de aplicação. 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 aplicativo.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/submissions/1152921504621243610/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.