Partilhar via


Efetuar um envio de complemento

Use esse método na API de envio da Microsoft Store para confirmar um envio de complemento novo ou atualizado (também conhecido como produto no aplicativo ou IAP) para o Partner Center. A ação de confirmação alerta o Partner Center de que os dados de envio foram carregados (incluindo quaisquer ícones 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 complemento usando a API de envio da Microsoft Store, consulte Gerenciar envios de complementos.

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/inappproducts/{inAppProductId}/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 Produto no App corda Obrigatório A ID da Loja do complemento que contém o envio que você deseja confirmar. A ID da Loja está disponível no Partner Center e está incluída nos dados de resposta para solicitações para Obter todos os complementos e Criar um complemento.
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 submeter um pedido acessório. 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 complemento.

POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/9NBLGGH4TNMP/submissions/1152921504621230023/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 complemento usa um recurso do Partner Center que não é suportado atualmente pela API de envio da Microsoft Store.