Dá. O Google Ads tem uma API (a porta que o Google abre para outro sistema conversar com a conta). Ela deixa ler métricas, puxar termos de pesquisa e alterar campanhas por código. Exige projeto no Google Cloud com a API ativada, login autorizado e nível de acesso para contas reais. Orçamento, lance e pausa só mudam com aprovação humana.
Você anuncia no Google e passa o começo do dia abrindo aba por aba. Quer ver quanto gastou, que palavra puxou clique ruim e se a campanha ainda está no ar. Esse trabalho é o tipo que um script (um pequeno programa que faz a mesma tarefa sozinho) faz melhor. O que ele não deve fazer é decidir sozinho onde vai o seu dinheiro.
O que um sistema próprio consegue fazer com a API do Google Ads?
Na prática, três famílias de tarefa saem do painel e vão para o código:
| Tarefa | Exemplo | Risco |
|---|---|---|
| Ler | gasto do dia, cliques, conversões, custo por conversão | nenhum, só consulta |
| Limpar | termos de pesquisa que geraram clique inútil, virando palavra negativa | baixo |
| Mexer em valor ou status | orçamento, lance, meta de custo por aquisição, pausar | alto: é dinheiro correndo |
Ler é onde está quase todo o ganho de tempo. Um relatório que junta gasto, termos e conversões num lugar só substitui a volta diária pelo painel. Como montar esse tipo de visão consolidada está em como juntar dado de várias fontes num painel só.
O que a API exige antes da primeira chamada?
A regra mudou em 2026, e muito tutorial ainda descreve o modelo antigo. O token, ou seja, a espécie de senha técnica que identificava quem chamava a API, deixou de existir. Pela documentação oficial do token de desenvolvedor, esses tokens foram descontinuados em 9 de setembro de 2026.
O acesso passou a ser vinculado ao projeto do Google Cloud. E a conta de administrador, chamada MCC (a conta que gerencia várias contas de anúncio de uma vez), deixou de ser obrigatória para se inscrever.
O que sobra para configurar:
- um projeto no Google Cloud com a Google Ads API ativada;
- credenciais OAuth desse projeto, ou seja, o login em que você autoriza o sistema a agir na sua conta Google. Depois do login, elas viram um token de atualização (a chave que renova o acesso sem pedir login de novo);
- um nível de acesso que permita contas de produção;
- o identificador da conta de administrador em cada chamada, se o seu acesso à conta de anúncios passa por uma MCC.
O último item também está na documentação da API: quem acessa via conta de administrador e não informa esse cabeçalho recebe erro de permissão.
Quais são os níveis de acesso e qual basta para um negócio?
A página oficial de níveis de acesso lista quatro, todos gerenciados no projeto do Google Cloud:
| Nível | Contas reais? | Limite diário em produção | Como se consegue |
|---|---|---|---|
| Teste | não, só contas de teste | — | vem ao ativar a API |
| Exploração | sim | 2.880 operações | pedido no próprio console |
| Básico | sim | 15.000 operações | exige verificação da marca |
| Padrão | sim | sem limite | análise de cerca de 10 dias úteis |
Para quem administra as próprias campanhas, Exploração costuma bastar: libera conta real e o limite diário sobra para leitura e ajustes pontuais. Os níveis acima fazem sentido para ferramenta que atende muitas contas.
Como foi ligar isso numa conta real?
Montamos a conexão no fim de agosto de 2026 e ela só funcionou de ponta a ponta em 17 de setembro, contra uma conta real. No caminho houve três tropeços que nenhum passo a passo mencionava.
O que deu errado no caminho até a conta real?
O primeiro: um e-mail de aprovação de acesso básico chegou em 1º de setembro, e mesmo assim a chamada de teste falhava dizendo que o projeto não estava aprovado para produção. O motivo era a migração: o projeto do Google Cloud tinha nascido de novo no nível Teste, no sistema novo. Pedimos Exploração pelo console e a aprovação saiu em menos de um minuto.
O segundo: montar a requisição à mão, direto no endereço da API, devolveu erro 404 (o código de “endereço não encontrado”) na nossa tentativa. Com a biblioteca oficial em Python (uma linguagem de programação), a mesma consulta trouxe as campanhas reais da conta.
O terceiro: o servidor local, ou seja, o programa no próprio computador que recebe a resposta do login, caiu depois do redirecionamento. O código de autorização continuava na barra de endereço por alguns minutos. Deu para trocá-lo por token sem refazer o consentimento.
O código foi escrito e depurado com o Claude Code, e as credenciais ficam num arquivo fora do repositório e fora do controle de versão.
Quem aprova cada mudança, e o que impede um erro caro?
Uma divisão escrita antes do primeiro comando de escrita, e não depois do primeiro susto. A nossa ficou assim:
- Pode fazer sem perguntar, e mostrar depois o que mudou: metas e ações de conversão, palavras negativas, correções técnicas de configuração.
- Sempre para e pede aprovação, mostrando valor atual e valor novo: meta de custo por aquisição, orçamento, lance ou teto de custo por clique, ajustes de lance por local ou dispositivo, pausar campanha.
- Nunca faz: ativar campanha ou anúncio. Toda campanha criada por código sai pausada, e quem liga é uma pessoa.
Em campanha ativa, a regra aperta: um “pode seguir” dado para um valor não vale para o próximo. Cada número novo passa por um OK novo. Como dar autonomia a um agente sem transformar isso em aprovação de cada passo está em como fazer o agente rodar sozinho sem aprovar cada passo.
Por que confirmar valor se a própria conta pode mudar sozinha?
Porque o número que o script leu ontem pode não ser o de hoje. O Google Ads tem a opção de aplicar recomendações automaticamente, e entre elas estão ajustar metas de custo por aquisição, trocar a estratégia de lance e adicionar palavras-chave. Além disso, outra pessoa com acesso à conta pode ter mexido.
Por isso a aprovação mostra o valor atual lido na hora, lado a lado com o novo. Se o valor atual já não bate com o que você esperava, isso é um alerta, não um detalhe: algo mudou na conta sem passar por você.
Qual armadilha o status de pausa esconde?
A pausa não mora num lugar só. Quando uma campanha é importada com tudo pausado, ela fica pausada em quatro níveis: campanha, grupo de anúncios, palavra-chave e anúncio. Ativar só a campanha faz o painel mostrá-la como ativada, e mesmo assim ela entrega zero impressão.
Descobrimos isso em agosto de 2026, conferindo campanhas recém-importadas. O diagnóstico natural seria culpar palavra sem volume ou lance baixo. O erro estaria três níveis abaixo.
Duas consequências para quem automatiza. O script precisa ler os quatro níveis antes de concluir qualquer coisa sobre veiculação. E ligar continua sendo decisão humana, nível por nível.
Quando vale automatizar o Google Ads — e quando não?
Se aplica bem:
- Quem abre o painel todo dia para as mesmas conferências. Gasto, termos e conversões num relatório só substituem essa volta.
- Quem limpa termos de pesquisa com frequência. Transformar clique inútil em palavra negativa é tarefa repetida e de risco baixo.
- Quem cuida de várias campanhas ou contas. Aí a leitura por código economiza mais, e a MCC organiza o acesso.
Não se aplica tão bem:
- Uma campanha pequena, olhada uma vez por semana. Projeto no Google Cloud, login autorizado e nível de acesso dão mais trabalho que a própria volta pelo painel.
- Quando não há ninguém para aprovar mudança no dia. A trava depende de uma pessoa dizer sim ou não. Sem ela, a automação só serve para ler.
- Quando ninguém vai cuidar das credenciais. O acesso precisa ficar guardado fora do código, e alguém tem que saber onde.
O que a gente faria no seu lugar?
A gente começaria só lendo. Na tabela das três famílias de tarefa, ler é risco zero e é onde está quase todo o ganho de tempo. Um relatório diário já tira você da volta pelo painel.
Para acesso, a gente pediria o nível Exploração. Ele libera conta real, saiu em menos de um minuto no nosso caso, e 2.880 operações por dia sobram para quem administra as próprias campanhas.
O que a gente não faria: deixar o código mudar orçamento, lance ou pausa sem mostrar o valor atual e o novo. Não ativaria campanha por código. E não montaria requisição à mão quando existe biblioteca oficial, porque foi aí que tomamos o erro 404.
Em resumo
A API do Google Ads permite ler métricas, limpar termos de pesquisa e ajustar campanhas por código, desde que o projeto do Google Cloud tenha a API ativada, login OAuth e pelo menos o nível Exploração para contas reais.
O que separa automação útil de prejuízo é a trava: orçamento, lance, meta de custo e pausa só mudam com aprovação humana mostrando valor atual e novo, e nenhuma campanha é ativada por código.
Quando a automação quebra mesmo com a tela dizendo que está tudo certo, o caminho está em quem conserta a automação que a IA construiu.
Este artigo faz parte do pilar Operação e processo — como documentar sem virar burocracia.
Deixe um comentário