Este guia usa uma biblioteca cliente para recuperar campanhas do Google Ads.
Para ativar o acesso à API, primeiro consiga as credenciais do OAuth2 necessárias.
Em seguida, adicione os detalhes da conta e a autorização a um arquivo de configuração. Quando o arquivo de configuração estiver configurado, você estará pronto para chamar a API.
Parâmetros de configuração para a biblioteca de cliente
Forneça as seguintes informações no arquivo de configuração da sua biblioteca de cliente.
- Token de desenvolvedor
Seu token de desenvolvedor permite que seu aplicativo acesse a API, mas não está restrito a apenas uma conta do Google Ads. Depois que seu token é aprovado, você pode usar o mesmo token para solicitações em todas as suas contas do Google Ads, mesmo que elas não estejam vinculadas à conta de administrador do Google Ads associada ao token.
As contas que você gerencia são autorizadas pelas credenciais do OAuth da conta de administrador. Uma conta de administrador requer apenas um conjunto de credenciais para gerenciar todas as subcontas.
Somente tokens aprovados podem se conectar à API para contas de produção do Google Ads. Já os pendentes podem se conectar apenas às contas de teste.
Para recuperar seu token de desenvolvedor, faça login na sua conta de administrador e navegue até a Central de API (FERRAMENTAS E CONFIGURAÇÕES > CONFIGURAÇÃO > Central de API).
- ID de cliente
O ID de cliente é o número da conta do cliente do Google Ads que você quer gerenciar com a API, geralmente no formato
123-456-7890.
Você também tem a opção de remover o ID de cliente do arquivo de configuração e defini-lo de modo programático. Depois que seu token de desenvolvedor for aprovado, será possível usar um ID de cliente de uma conta de produção em vez de uma conta de teste.
- ID e chave secreta do cliente do OAuth2
O ID e a chave secreta do cliente OAuth2 mapeiam seu aplicativo cliente para um projeto no Console de APIs do Google e são usados para autenticação OAuth2, permitindo que seu aplicativo opere em nome da sua conta. Elas identificam seu aplicativo para o Google e permitem que você gere tokens OAuth para gerenciar usuários do Google Ads. Consulte Criar um ID e uma chave secreta do cliente para mais detalhes.
- Tokens de atualização e de acesso do OAuth2
Para que seu aplicativo possa acessar dados particulares usando a API, ele precisa de um token de acesso OAuth2 que conceda acesso à API.
Se você estiver usando as bibliotecas de cliente, o token de acesso do OAuth2 será feito automaticamente. Caso contrário, tente receber tokens por meio do OAuth Playground.
Os tokens de acesso do OAuth2 expiram após um período. Por esse motivo, as bibliotecas de cliente usam o token de atualização do OAuth2 para regenerar automaticamente o token de acesso do OAuth2. O token de acesso e atualização tem instruções para criar esse token.