Method: accounts.homepage.claim

Reivindica a página inicial de uma loja. A execução desse método requer acesso de administrador.

Se a página inicial já tiver sido reivindicada, a verificação será refeita (a menos que o comerciante esteja isento da reivindicação, o que também é isento da verificação) e retornará uma resposta positiva. Se a propriedade não puder mais ser verificada, um erro será retornado, mas a reivindicação não será apagada. Em caso de falha, uma mensagem de erro canônico será retornada: * PERMISSION_DENIED: o usuário não tem as permissões necessárias na conta do MC. * FAILED_PRECONDITION: - A conta não é uma conta do Merchant Center. - A conta do MC não tem uma página inicial. - A reivindicação falhou. Nesse caso, a mensagem de erro vai conter mais detalhes.

Solicitação HTTP

POST https://merchantapi.googleapis.com/accounts/v1beta/{name=accounts/*/homepage}:claim

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
name

string

Obrigatório. O nome da página inicial a ser reivindicada. Formato: accounts/{account}/homepage

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "overwrite": boolean
}
Campos
overwrite

boolean

Opcional. Quando definida como true, essa opção remove qualquer reivindicação existente no site solicitado e a substitui por uma reivindicação da conta que faz a solicitação.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Homepage.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/content

Para mais informações, consulte a Visão geral do OAuth 2.0.