Início rápido

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Neste guia, usamos uma biblioteca de cliente para recuperar campanhas do Google Ads.

Para ativar o acesso à API, primeiro acesse as credenciais do OAuth2 necessárias.

Em seguida, adicione a autorização e os detalhes da conta a um arquivo de configuração. Depois que o arquivo de configuração estiver configurado, você estará pronto para chamar a API.

Parâmetros de configuração da 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 o token não está restrito a apenas uma conta do Google Ads. Depois que seu token for aprovado, você poderá usar o mesmo token para solicitações com 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 por 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. Os tokens pendentes podem se conectar apenas 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, 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 o 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 aplicativo cliente para um projeto no Console de APIs do Google e são usados para autenticação OAuth2, permitindo que o 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 app possa acessar dados particulares usando a API, ele precisa receber um token de acesso OAuth2 que conceda acesso à API.

Se você estiver usando as bibliotecas de cliente, o token de acesso do OAuth2 será cuidado automaticamente. 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 um novo automaticamente. O token de acesso e atualização tem instruções para criar o token de atualização.