Confirmar 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 todos os í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 complemento.
Pré-requisitos
Para usar este método, primeiro você precisa fazer o seguinte:
- Se você ainda não tiver feito 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. Após obter um token de acesso, você tem 60 minutos para usá-lo antes dele expirar. Depois que o token expirar, você poderá obter um novo.
- Crie um envio de complemento e atualize o envio com as alterações necessárias nos dados de envio.
Solicitar
Esse 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 | URI da solicitação |
|---|---|
| POST | 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 | string | Obrigatório. O token de acesso do Azure AD no Token<de portador> do formulário. |
Parâmetros da solicitação
| Nome | Tipo | Descrição |
|---|---|---|
| inAppProductId | string | Obrigatória. 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. |
| submissionId | string | Obrigatória. O ID do envio que você deseja confirmar. Essa ID está disponível nos dados de resposta para solicitações para criar um envio de complemento. Para um envio criado no Partner Center, essa ID também está disponível na URL da página de envio no Partner Center. |
Corpo da solicitação
Não forneça um corpo de solicitação para esse 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 da 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 | Type | Descrição |
|---|---|---|
| status | string | O status do envio. Esse valor pode ser um dos seguintes:
|
Códigos do 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 | Description |
|---|---|
| 400 | Os parâmetros de solicitação são inválidos. |
| 404 | Não foi possível encontrar o envio especificado. |
| 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 atualmente não tem suporte na API de envio da Microsoft Store. |