Compartilhar 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 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 envio de um aplicativo usando a API de envio da Microsoft Store, consulte Gerenciar envios de aplicativo.

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 uma submissão de aplicativo e, em seguida, atualizar a submissão com as mudanças 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}/submissions/{submissionId}/commit

Cabeçalho da solicitação

Cabeçalho Tipo Descrição
Autorização cadeia de caracteres 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 cadeia de caracteres Obrigatório O ID da Loja do aplicativo que contém a submissão que você deseja confirmar. Para obter mais informações sobre a ID da Loja, consulte Exibir detalhes da identidade do aplicativo.
ID de submissão cadeia de caracteres Obrigatório O ID da submissão que você deseja cometer. Esta ID está disponível nos dados de resposta para solicitações para criar uma submissão de aplicativo. 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 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 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 cadeia de caracteres 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.