As chamadas para a API Search Ads 360 Reporting geralmente são feitas pela biblioteca de cliente. Consulte Explicações sobre bibliotecas de cliente para mais informações. No entanto, o conhecimento sobre a estrutura dos detalhes da solicitação pode ser útil durante os testes e a depuração.
A API Search Ads 360 Reporting é uma API gRPC com vinculações REST. Isso significa que você pode fazer chamadas para a API de duas maneiras alternativas:
- Método preferencial
- Use uma biblioteca de cliente:
- Crie o corpo da solicitação como um buffer de protocolo.
- Envie a solicitação ao servidor usando HTTP/2.
- Desserialize a resposta para um buffer de protocolo.
- Interprete os resultados.
- Método alternativo opcional
- Usar REST:
- Crie o corpo da solicitação como um objeto JSON.
- Envie a solicitação para o servidor usando o HTTP 1.1.
- Desserialize a resposta como um objeto JSON.
- Interprete os resultados.
Consulte APIs do Google Cloud para mais informações.
As seções a seguir se aplicam aos protocolos gRPC e REST.
Nomes de recursos
A maioria dos objetos na API são identificados pelas strings de nome de recurso. Essas strings também servem como URLs ao usar a interface REST.
Consulte Referência > REST para mais informações sobre os recursos compatíveis e a representação do caminho deles. O mesmo formato é usado para outros serviços.
IDs compostos
Se o ID de um objeto não for globalmente exclusivo, um ID composto para esse objeto será construído precedido pelo ID pai e um til (~).
Por exemplo, como o ID do anúncio de um grupo de anúncios não é globalmente exclusivo, o ID do objeto pai (grupo de anúncios) é adicionado a ele, resultando em um ID composto exclusivo.
Exemplo: AdGroupId de 123 + ~ + AdGroupAdId de 45678
= ID do anúncio do grupo de anúncios composto de 123~45678.
Cabeçalhos de solicitação
Os cabeçalhos HTTP (ou metadados gRPC) nas seções a seguir precisam ser incluídos no corpo da solicitação.
Autorização
É necessário incluir um token de acesso OAuth2 no formulário:
Authorization: Bearer [OAUTH_2.0_ACCESS_TOKEN]
O token precisa identificar uma conta de administrador que atue em nome de um cliente ou um anunciante que gerencie diretamente a própria conta de subadministrador ou cliente. Consulte Sobre as contas de administrador do Search Ads 360 e Autenticação para saber mais.
Cabeçalho do ID de cliente de login
O cabeçalho login-customer-id é necessário ao usar uma conta de administrador para
acessar uma conta de subadministrador ou cliente. Ele não é necessário ao acessar uma
conta de subadministrador ou de cliente diretamente. Embora não seja estritamente necessário, recomendamos sempre especificar o login-customer-id para usuários autenticados que
têm acesso a mais de uma conta. Isso evita ambiguidades e impede
que o contexto seja definido involuntariamente para a conta incorreta.
A solicitação precisa incluir o ID do cliente do usuário autorizado, sem
hifens (-), por exemplo:
https://searchads360.googleapis.com/VERSION_NUMBER/customers/CUSTOMER_ID/campaignBudgets
Configurar o login-customer-id é equivalente a escolher uma conta na
interface do Search Ads 360 depois de fazer login ou clicar na imagem do perfil no canto
superior direito.
Cabeçalhos de resposta
Os cabeçalhos a seguir (ou gRPC trailing-metadata) são retornados com o corpo da resposta. Recomendamos que você registre esses valores para fins de depuração.
ID da solicitação
O cabeçalho request-id é uma string que identifica a solicitação de forma exclusiva.