Guia operacional Guia operacional de Google Ads API
0 de 7
Google Ads API

Configure a API sem se perder no painel do Google.

Um guia direto para criar a MCC, configurar o Google Cloud, gerar OAuth, solicitar o Developer Token e entregar tudo para o Claude Code configurar a skill. A lógica é simples: fazer a parte burocrática uma vez e deixar a operação virar conversa.

Começar guia
1

Passo 1 de 7

Criar a conta MCC

A skill precisa de uma conta de gerenciamento, também chamada de MCC, para se conectar à API. Se você já tem uma MCC, avance para o passo 2. Se só tem uma conta normal de Google Ads, crie a MCC primeiro.

Criando a MCC
  1. Acesse ads.google.com/home/tools/manager-accounts/ e clique em Criar conta de gerenciamento.
  2. Faça login com a mesma conta Google que já tem acesso ao Google Ads.
  3. Escolha um nome para o gerenciador, como o nome da empresa ou da agência.
  4. Selecione Gerenciar minhas próprias contas.
  5. Escolha país, fuso horário e moeda. Depois clique em Enviar.
  6. Com isso, a MCC fica criada.
Vincular a conta existente
  1. Dentro da MCC, vá em Contas > Performance e clique no botão azul de adicionar.
  2. Selecione Vincular conta existente e informe o Customer ID da conta Google Ads normal.
  3. Entre na conta normal, vá em Configurações > Acesso à conta e aceite o convite enviado pela MCC.
Nota: a MCC não substitui a conta de anúncios. Ela funciona como uma camada de gerenciamento para agrupar e acessar contas.
2

Passo 2 de 7

Criar o projeto no Google Cloud Console

O projeto no Google Cloud é onde ficam as credenciais que a API usa para autenticar a conexão: Client ID e Client Secret.

Criando o projeto
  1. Acesse console.cloud.google.com com a mesma conta Google do Google Ads.
  2. No topo da página, abra o seletor de projetos, ao lado do logo do Google Cloud.
  3. Clique em Novo Projeto.
  4. Preencha o nome do projeto. Sugestão: Google Ads API.
  5. Organização e local podem ficar no padrão. Clique em Criar.
  6. Depois que o projeto for criado, selecione esse projeto no dropdown do topo.
Nota: pense no projeto como uma pasta técnica. Ele agrupa APIs, credenciais e permissões.
3

Passo 3 de 7

Ativar a API e criar as credenciais OAuth

Agora você ativa a Google Ads API no projeto e cria as credenciais OAuth. É a etapa mais cheia de telas, mas é só seguir a sequência.

Parte A: ativar a API

Ativando a Google Ads API
  1. No Google Cloud Console, vá em APIs e Serviços > Biblioteca.
  2. Pesquise por Google Ads API.
  3. Abra o resultado e clique em Ativar.

Parte B: tela de consentimento OAuth

Configurando o consentimento
  1. Vá em APIs e Serviços > Tela de consentimento OAuth.
  2. Selecione Externo e clique em Criar.
  3. Preencha o nome do app e o e-mail de suporte. Os outros campos podem ficar em branco quando não forem obrigatórios.
  4. Em escopos, clique em Adicionar ou remover escopos, busque Google Ads API e selecione https://www.googleapis.com/auth/adwords.
  5. Em usuários de teste, adicione o seu e-mail, o mesmo que acessa o Google Ads.
  6. Confira o resumo e volte ao painel.

Parte C: criar Client ID OAuth

Gerando as credenciais
  1. Vá em APIs e Serviços > Credenciais.
  2. Clique em Criar credenciais > ID do cliente OAuth.
  3. Em tipo de aplicativo, escolha App para computador.
  4. Dê um nome para a credencial ou deixe o padrão.
  5. Clique em Criar.
  6. Copie o Client ID e o Client Secret. Guarde os dois valores.
Credenciais deste passo 
GOOGLE_ADS_CLIENT_ID="teu-client-id.apps.googleusercontent.com"
GOOGLE_ADS_CLIENT_SECRET="teu-client-secret"
4

Passo 4 de 7

Obter o Developer Token

O Developer Token identifica que você tem permissão para usar a API. Ele fica dentro do Google Ads, na conta MCC, não no Google Cloud.

Pegando o token
  1. Abra ads.google.com e entre na sua conta MCC.
  2. Vá em Ferramentas e Configurações e procure por Central de API.
  3. Se for a primeira vez, aceite os termos.
  4. Copie o Developer Token que aparece na tela.
Atenção: o token começa com acesso de teste. Para usar com contas reais, solicite Basic Access na própria Central de API. A aprovação costuma levar de 3 a 7 dias úteis.
Solicitando Basic Access
  1. Na Central de API, clique em Aplicar para Basic Access.
  2. Preencha o formulário. O campo mais importante é Use Case Description.
  3. Em API Token Contact Email, informe seu e-mail.
  4. Em Direct or Third Party Tool, selecione Direct.
  5. Envie e aguarde a análise.

Use esta descrição pronta no campo Use Case Description:

Use Case Description 
We use the Google Ads API to manage advertising campaigns for our own business accounts. Our internal tool connects via the API to read campaign performance data (impressions, clicks, conversions, cost), create and update campaigns, ad groups, keywords, and responsive search ads, manage negative keyword lists, and generate performance reports. All operations are performed on accounts we own or manage directly through our MCC. We do not provide API access to third parties. The tool is used by our internal marketing team for day-to-day campaign management and optimization.
Respostas para o formulário
  1. Describe your business model: cole o texto pronto acima.
  2. Design documentation: envie a documentação do funcionamento da ferramenta, caso o Google solicite.
  3. Who will have access: marque Internal users - employees only.
  4. Tool developed by someone else? marque No.
  5. App Conversion Tracking and Remarketing API? marque No.
  6. Campaign types supported: escreva Search, Performance Max.
  7. Google Ads capabilities: marque Campaign Creation, Campaign Management, Reporting e Keyword Planning Services.
Credencial deste passo 
GOOGLE_ADS_DEVELOPER_TOKEN="teu-developer-token"
5

Passo 5 de 7

Pegar o Login Customer ID

O Login Customer ID é o ID da conta MCC. É aquele número de 10 dígitos que aparece no canto superior do Google Ads quando você está logado na MCC.

Copiando o ID correto
  1. No Google Ads, entre na conta MCC.
  2. Copie o Customer ID no formato XXX-XXX-XXXX.
  3. Remova os hífens antes de salvar. Exemplo: 123-456-7890 vira 1234567890.
Credencial deste passo 
GOOGLE_ADS_LOGIN_CUSTOMER_ID="1234567890"
Pronto: agora você tem Client ID, Client Secret, Developer Token e Login Customer ID.
6

Passo 6 de 7

Mandar o Claude configurar

Com as credenciais em mãos, volte para o VS Code ou terminal com a pasta da skill aberta e mande este comando para o Claude:

Mensagem para o Claude configura a skill de google ads pra mim. meu client id é [COLA AQUI], client secret é [COLA AQUI], developer token é [COLA AQUI] e meu MCC é [COLA AQUI]
O que o Claude faz automaticamente
  1. Cria o arquivo .env com todas as credenciais no lugar certo.
  2. Instala as dependências Python, como google-ads e google-auth-oauthlib.
  3. Roda setup.py oauth para gerar o refresh token.
  4. Abre o navegador para você autorizar o acesso com a conta Google.
  5. Testa a conexão com setup.py test e mostra as contas acessíveis.
Fluxo ideal: você não precisa editar arquivo manualmente. Se der erro, mande a mensagem do erro para o Claude continuar a configuração.
7

Passo 7 de 7

Cadastrar as contas e testar

Depois que a conexão funcionar, informe ao Claude qual é a conta principal de Google Ads. Ele cadastra isso no arquivo contas.yaml.

Exemplo minha conta principal é a Loja do João, customer id 9876543210
Pedidos que você pode fazer depois
  1. me mostra as campanhas da Loja do João
  2. quero os insights dos últimos 30 dias
  3. cria uma campanha de search chamada Promoção Verão com orçamento de R$50/dia
Configuração finalizada: a partir daqui, a operação do Google Ads pode ser conduzida por conversa.

Agora o técnico trabalha a favor da estratégia.

Com a API configurada, você deixa de depender de cliques repetitivos e passa a operar campanhas, relatórios, keywords e anúncios com uma interface conversacional.

color: var(--text);