Este guia usa uma biblioteca de cliente para recuperar campanhas do Google Ads.
Para ativar o acesso à API, primeiro acesse as credenciais necessárias do OAuth2.
Em seguida, adicione os detalhes da conta e autorização a um arquivo de configuração. Depois de configurar o arquivo de configuração, você já pode 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 app acesse a API, mas ele não está restrito a apenas uma conta do Google Ads. Depois que seu token for aprovado, você poderá usá-lo em solicitações de todas as suas contas do Google Ads, mesmo que elas não estejam vinculadas à conta de administrador associada a ele.
As contas que você gerencia são autorizadas pelas credenciais do OAuth da conta de administrador. Uma conta de administrador exige 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 tokens pendentes só podem ser conectados a 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 de cliente do Google Ads que você quer gerenciar com a API, normalmente 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 do cliente e a chave secreta do cliente OAuth2 mapeiam seu app 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 app no Google e permitem gerar 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
Antes de acessar os dados particulares usando a API, seu app precisa receber um token de acesso OAuth2 que conceda o acesso à API.
Se você estiver usando as bibliotecas de cliente, o token de acesso do OAuth2 será automaticamente gerenciado para você. Caso contrário, tente receber tokens pelo 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 gerar automaticamente um novo token de acesso. O token de acesso e atualização tem instruções para criar esse token.