Google Ads 2027 · Capítulo 24 de 26 · 15 min
Automatizar a rotina com assinatura humana
Ask Advisor, Google Ads Editor, scripts e API tiram o trabalho repetitivo da mão do gestor, e cada gasto continua aprovado por uma pessoa.
Este capítulo faz parte do curso gratuito Google Ads 2027.
Uma conta com várias campanhas gera dezenas de ajustes pequenos por semana, e quem faz tudo à mão perde o tempo de decidir. Delegar sem controle também custa: um script que pausa campanha por CPA alto antes de a conversão chegar derruba a venda de sábado. A decisão deste capítulo é o que entregar a cada camada de automação e quem assina cada ação com gasto.
CPA é o custo por aquisição, o quanto se paga por lead ou venda. Em outubro de 2026 existem quatro camadas de delegação: os assistentes do Google (Ask Advisor e Ads Advisor), o Google Ads Editor, os scripts e a Google Ads API, com a Data Manager API ao lado. A tabela resume cada uma e o ponto em que uma pessoa aprova.
| Camada | O que faz | Situação em outubro de 2026 | Quem aprova |
|---|---|---|---|
| Ask Advisor | Agente com Gemini que conversa sobre Google Ads e Google Analytics, diagnostica e cria campanha a partir de um pedido escrito | Beta só para contas em inglês desde 20/05/2026; sem anúncio para o português | Uma pessoa revisa e assina toda ação com gasto |
| Ads Advisor | Assistente dentro do Google Ads | Contas em inglês; recursos de segurança anunciados em maio de 2026, sem data para o português | Uma pessoa revisa e assina toda ação com gasto |
| Google Ads Editor | Aplicativo de computador que baixa a conta, edita em massa sem conexão e publica tudo de uma vez | Versão 2.13.2, de 24/07/2026 | Quem publica revisa a lista de alterações antes |
| Scripts | Código em JavaScript que roda dentro da conta em horário marcado, lê relatórios e altera campanhas | Sem novidade publicada em 2026; o que mudou foi a autenticação | O gestor define, por escrito, o que cada script pode alterar |
| Google Ads API | Porta por onde um sistema externo lê relatórios, cria campanhas e envia conversões sem abrir a tela | Versão 26 lançada em 14/10/2026 | O dono da credencial responde por cada mudança |
| Data Manager API | Porta que leva o dado próprio da empresa, como CRM e venda em loja, ao Google | Aberta a todos desde dezembro de 2025 | Quem decide quais dados saem e com qual consentimento |
Fonte: Posts oficiais do Google e Google Ads Developer Blog, consulta em 24/10/2026
Ver como texto
Quatro camadas de delegação, com a pessoa que aprova em cada uma
Ask Advisor e Ads Advisor, Google Ads Editor, scripts e Google Ads API com a Data Manager API ao lado. Em todas as camadas, a mudança com gasto passa por uma pessoa que aprova.
O Ask Advisor é o agente que conversa entre produtos do Google, em beta só em inglês; o Ads Advisor é o assistente dentro do Google Ads, também sem anúncio de versão em português até outubro de 2026. Anunciado em 20 de maio de 2026, o Ask Advisor mantém o contexto entre tarefas, cria campanha a partir de um pedido escrito com dados do Merchant Center e cruza Ads e Analytics para gerar diagnósticos. Uma conta operada em português fica fora do beta do Ask Advisor e precisa conferir na própria interface se o Ads Advisor já aparece.
Ver como texto
Post de 20 de maio de 2026 do blog oficial apresentando o Ask Advisor, agente de IA que reúne as ferramentas de marketing.
O mesmo evento mostrou o agente dentro do próprio anúncio, como o agente de marca que conversa com o cliente no lugar do formulário (Business Agent for Leads). Esses formatos estão em teste nos Estados Unidos, sem data para o Brasil.

Ver como texto
Gestora revisa no notebook uma proposta gerada por um assistente de IA e se prepara para assinar a aprovação, enquanto as engrenagens de automação aguardam diante de uma cancela.
Quando o agente chegar à sua conta, o uso que compensa segue uma regra simples: pergunta de diagnóstico, sim; ação com gasto sem revisão, não. Perguntar por que o CPA da campanha de planejados subiu na semana passada rende uma hipótese em segundos. Deixar que ele crie e publique a campanha nova rende uma fatura antes da primeira revisão.
- Etapa 1 de 6: 1. Prompt com objetivo
O que decidir, para qual campanha, em qual período
- Etapa 2 de 6: 2. Contexto sem dado confidencial
Métricas da conta sim; margem, lista de clientes e senha, não
- Etapa 3 de 6: 3. Resposta com origem
Cada número da resposta aponta relatório e data
- Etapa 4 de 6: 4. Verificação humana
Alguém abre o relatório citado e confere o número
- Etapa 5 de 6: 5. Aprovação de quem assina o gasto
Mudança com orçamento leva nome e hora
- Etapa 6 de 6: 6. Registro
Prompt, resposta e decisão ficam na documentação da conta
Ver como texto
- 1. Prompt com objetivo: O que decidir, para qual campanha, em qual período
- 2. Contexto sem dado confidencial: Métricas da conta sim; margem, lista de clientes e senha, não
- 3. Resposta com origem: Cada número da resposta aponta relatório e data
- 4. Verificação humana: Alguém abre o relatório citado e confere o número
- 5. Aprovação de quem assina o gasto: Mudança com orçamento leva nome e hora
- 6. Registro: Prompt, resposta e decisão ficam na documentação da conta
No Google Ads Editor, o fluxo tem cinco etapas, e a quarta é a que salva a conta: revisar a lista de alterações, onde o Editor marca erro de política e campo vazio. Quem publica sem abrir a lista descobre o erro no dia seguinte, no relatório de reprovações.
Ver como texto
Página de notas da versão 2.13 do Google Ads Editor, com novos recursos e índice de versões recentes.
Ver como texto
O fluxo do Google Ads Editor em cinco etapas
Baixar a conta, editar em massa, importar uma planilha CSV, revisar a lista de alterações e publicar. A quarta etapa é a que salva a conta, porque o Editor marca ali erro de política e campo vazio.
Exemplo: o Editor serve para dois trabalhos repetitivos feitos em lote. O primeiro é renomear 9 campanhas e 38 grupos de anúncios para a nomenclatura do capítulo da estrutura e dos acessos. O segundo é aplicar uma lista compartilhada de 212 palavras negativas a seis campanhas de Pesquisa. A lista de alterações é revisada antes de publicar.
Quatro usos comuns de scripts são alerta de orçamento e CPA, pausa condicionada, detecção de anomalia e relatório automático por e-mail. A tabela traz exemplos com limites de ação e responsabilidade humana definidos.
Ver como texto
Página do script Detector de anomalias da conta, com a planilha de exemplo de alertas e o menu de soluções.
| Script | Gatilho | O que faz | Quem aprova |
|---|---|---|---|
| Alerta de orçamento | Gasto do dia acima de 130% do orçamento diário até as 15h | Envia e-mail e mensagem; não altera nada | Ninguém: só avisa |
| Alerta de CPA | CPA de lead dos últimos 7 dias acima de R$ 320, com dados de 3 dias atrás | Envia e-mail com a campanha e o termo que puxou o custo | Ninguém: só avisa |
| Pausa condicionada | Página de destino devolve erro 404 ou 500 em duas leituras seguidas | Pausa o grupo de anúncios ligado à página e avisa | Responsável pela conta reativa depois de confirmar a página |
| Relatório semanal | Toda segunda, 7h | Grava na planilha gasto, conversões, CPA e ROAS por campanha | Ninguém: só escreve |
Nenhum script da conta pausa campanha por métrica de conversão. A conversão de lead chega ao CRM com atraso de até 3 dias e a pausa automática leria um buraco, não uma queda.
A Google Ads API fala uma linguagem de consulta própria, o GAQL, e exige três coisas: um token de desenvolvedor, a senha técnica que identifica o programa; uma conta de administrador, ou a nova entrada pela Google Cloud Console; e credenciais OAuth, o protocolo que autoriza um programa a agir em nome de uma conta Google.
O calendário de versões é o que quebra integração em silêncio. O Google sustenta cada versão principal por cerca de um ano, e a integração parada numa versão encerrada para de responder no dia do encerramento. A v22 saiu do ar em 7 de outubro de 2026; a v23 sai em fevereiro de 2027, a v24 em maio de 2027, a v25 em agosto de 2027 e a v26, lançada em 14 de outubro de 2026, em novembro de 2027.
Ver como texto
Página da Google Ads API sobre descontinuação e desativação de versões, com regras de ciclo de vida e a tabela de datas.
| Versão | Situação em 24/10/2026 | Encerramento |
|---|---|---|
| v22 | Encerrada; pedidos nessa versão falham | 07/10/2026 |
| v23 | Ativa | Fevereiro de 2027 |
| v24 | Ativa | Maio de 2027 (a v24.2 em junho) |
| v25 | Lançada em 22/07/2026; v25.1 em 19/08 e v25.2 em 23/09, versões menores sem quebra | Agosto de 2027 |
| v26 | Lançada em 14/10/2026: estudos de Search Lift pela API e declaração de publicidade política da União Europeia opcional para campanhas que miram só locais fora dela | Novembro de 2027 |
Calendário anunciado em 12/10/2026: a partir da v26, mais versões por ano, até duas por mês, mantendo quatro principais por ano, cada uma com um ano de suporte.
Fonte: Google Ads API, tabela de descontinuação e encerramento, e Google Ads Developer Blog, consulta em 24/10/2026
Datas que mexem na automação da conta, de junho de 2026 a novembro de 2027
- 15/06/2026Concluído
API fecha a importação offline para quem não usava
Integrações existentes seguem enquanto migram
- 22/07/2026Concluído
Google Ads API v25
Meta de retenção por fidelidade e relatórios de YouTube por duração
- 05/08/2026Concluído
Chave de acesso para nova credencial
Vale para Editor, scripts, BigQuery Data Transfer e Looker Studio
- 31/08/2026Concluído
Políticas de desenvolvedor
Projeto próprio no Google Cloud, sem intermediário
- 10/09/2026Concluído
Data Manager API adota o padrão ECAPI
Mesmo dia da nova entrada na API pelo Google Cloud Console
- 07/10/2026Concluído
Encerramento da v22
Integração na v22 parou de responder
- 14/10/2026Concluído
Google Ads API v26
Search Lift consultável pela API
- fev/2027Previsto
Encerramento da v23
Próxima parada obrigatória de migração
- ago/2027Previsto
Encerramento da v25
Um ano de suporte por versão principal
- nov/2027Previsto
Encerramento da v26
Data prevista na tabela oficial
A autenticação mudou em 5 de agosto de 2026. Gerar nova credencial de longa duração da API (refresh token, a credencial que mantém a integração conectada) passou a exigir chave de acesso (passkey), a senha sem senha do Google; o segundo fator por SMS ou aplicativo deixou de valer nessa etapa. A regra alcança o Editor, os scripts, o BigQuery Data Transfer e o Looker Studio, porque todos passam pelo mesmo OAuth.
As conversões ganharam uma porta fechada e outra aberta. Desde 15 de junho de 2026 a Google Ads API não aceita quem nunca importou conversão offline; quem já usava segue enquanto migra. A porta aberta é a Data Manager API, a interface da Central de dados (Data Manager), que em 10 de setembro adotou o ECAPI, padrão comum de envio de conversões criado pelo IAB Tech Lab, a entidade técnica do mercado de publicidade digital. Com ele, parceiros como Zapier e Stape falam a mesma língua.
Ver como texto
Três caminhos da conversão offline até o Google Ads em 2026
Desde 15 de junho de 2026 a Google Ads API não aceita novos adotantes de importação de conversão offline; quem já usava segue enquanto migra. A Data Manager API, disponível a todos desde dezembro de 2025, e os conectores de CRM e as configurações por tag seguem abertos.
| Mudança | Data | O que fazer |
|---|---|---|
| Importação de conversão offline pela Google Ads API fechada a quem não usava | 15/06/2026 | O pedido novo volta com o erro CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE; usar a Data Manager API ou um conector de CRM |
| Chave de acesso (passkey) para gerar nova credencial de acesso | 05/08/2026 | Credenciais já emitidas seguem valendo; contas de serviço estão isentas |
| Google Ads API Developer Assistant 4.0.0 | 25/08/2026 | Ferramenta para desenvolvedores que leva as regras da API a assistentes de código, como Claude Code e Antigravity; não é o Ask Advisor nem o Ads Advisor |
| Políticas de desenvolvedor atualizadas | 31/08/2026 | Integração liga direto ao Google Ads, com projeto próprio no Google Cloud e sem intermediário (proxy); a equipe de conformidade do Google revisa integrações |
| Nova entrada na API pelo Google Cloud Console | 10/09/2026 | Dispensa conta de administrador; pedido de acesso básico analisado automaticamente, em minutos, depois da verificação de marca |
| Campanhas inteligentes deixam de ser criadas pela API | 23/09/2026 | As existentes continuam veiculando e podem ser editadas; ferramenta de terceiro que cria campanha inteligente para de funcionar nessa parte |
Fonte: Google Ads Developer Blog, posts de junho a setembro de 2026, consulta em 24/10/2026
A governança da API cabe em três perguntas: quem detém a credencial, o que ela pode alterar e onde fica o registro. Credencial em nome de um desenvolvedor que já saiu é uma porta aberta com a chave de outra pessoa. Desde 31 de agosto de 2026, a integração também precisa de projeto próprio no Google Cloud, e a agência que usa ferramenta de terceiro deve confirmar que ela liga direto ao Google Ads.
Armadilha comum: dar ao script ou à integração o mesmo poder do gestor. Um script que pausa por CPA, uma integração que sobe orçamento e um agente que cria campanha têm o mesmo defeito quando ninguém assina: a conta muda sozinha e a explicação chega depois da fatura.

Ver como texto
Uma chave antiga é retirada de uma fechadura digital e trocada por uma chave nova ligada a um celular com impressão digital, ao lado de uma pasta de registro.
Exemplo de limpeza das integrações: a integração com o RD Station, montada por planilha e conector de parceiro como no capítulo do CRM e da Central de dados, continua enviando leads qualificados sem tocar na API. Um relatório de custo escrito por um desenvolvedor externo em 2025 falava com a v22, que parou de responder em 7 de outubro de 2026; por isso precisava ser migrado para a v25 antes dessa data. A credencial antiga, em nome do desenvolvedor externo, é revogada e reemitida em nome da empresa, com a chave de acesso da pessoa responsável pela conta.
Depois da automação, o que se acompanha é o comportamento dos scripts e dos alertas. Exemplo: num período, nenhum script pausa campanha, e o alerta de CPA dispara duas vezes, uma por atraso do CRM e outra por um termo que vira negativa no mesmo dia. Os dois disparos mostram por que o alerta pede leitura humana antes de qualquer ação: um vinha de medição atrasada, o outro de um problema real da campanha.
Guia prático: o primeiro script de alerta e a primeira consulta à API. O Google mantém uma galeria de scripts prontos com planilha-modelo, e dois deles servem para quase toda conta: o detector de anomalias, que compara o dia com a média histórica e manda e-mail quando impressões, cliques ou conversões caem ou o custo dispara, e o verificador de links, que acha páginas de destino quebradas. Os dois só leem e avisam; não alteram campanha.
Detector de anomalias instalado, agendado e testado
Sete passos. O verificador de links segue o mesmo caminho, com agendamento diário.
Passo 1: Abra a página da solução Account Anomaly Detector na documentação de scripts
Deu certo quando: Você tem o código e o link da planilha-modelo.
Erro comum: Copiar script de fonte desconhecida sem ler o que ele altera.
Passo 2: Faça uma cópia da planilha-modelo no seu Drive
Deu certo quando: A planilha tem as linhas de limite e o campo de e-mail.
Erro comum: Editar a planilha pública em vez da cópia.
Passo 3: Em Ferramentas, Ações em massa, Scripts, crie um script e cole o código
O menu pode variar; a busca da interface acha Scripts pelo nome.
Deu certo quando: O editor mostra o código sem erro de sintaxe.
Erro comum: Colar numa subconta quando a intenção era cobrir todas as contas da MCC.
Passo 4: Preencha o endereço da sua planilha e os limites
Limites em porcentagem da média histórica e o e-mail que recebe o alerta.
Deu certo quando: A planilha mostra os limites que a equipe aprovou.
Erro comum: Limites apertados demais, que viram alarme diário e ninguém lê.
Passo 5: Autorize e rode em Visualizar
Deu certo quando: O log termina sem erro e a planilha mostra a data da última verificação.
Erro comum: Autorizar com a conta pessoal de quem vai sair da empresa.
Passo 6: Agende de hora em hora
O detector manda no máximo um e-mail por tipo de alerta por dia.
Deu certo quando: Chega o primeiro e-mail de teste na caixa certa.
Erro comum: Esquecer que os dados chegam com cerca de três horas de atraso e disparar alarme falso de madrugada.
Passo 7: Respeite os limites da ferramenta
Trinta minutos por execução; em MCC, até 50 contas em paralelo.
Deu certo quando: Nenhuma execução interrompida por tempo no histórico.
Erro comum: Um script de MCC que passa do tempo e deixa metade das contas sem verificação.
No fim você tem: Um alarme que avisa a equipe no mesmo dia em que a conta sai do padrão, sem poder de alterar nada.

Ver como texto
Planilha do Account Anomaly Detector com as semanas de histórico, os limites de impressões, cliques e conversões abaixo da média e de custo acima da média, o e-mail de alerta e a comparação entre os números do dia e a média histórica.

Ver como texto
Planilha de opções do Link Checker do Google Ads Scripts, com campos para escolher o que verificar e para onde enviar o relatório de links quebrados.
Primeira consulta GAQL, do validador ao número conferido
A linguagem de consulta do Google Ads, a GAQL, é a mesma nos scripts, na API e no servidor MCP oficial.
Passo 1: Monte a consulta no Query Builder da documentação da API
Escolha o recurso do FROM, como campaign, e os campos: nome, cliques, custo e conversões.
Deu certo quando: O construtor só oferece campos compatíveis entre si.
Erro comum: Escrever à mão e misturar campos que não podem aparecer juntos.
Passo 2: Adicione o período: segments.date DURING LAST_30_DAYS
Deu certo quando: A consulta tem uma janela explícita.
Erro comum: Consulta sem data, que devolve o acumulado da vida da conta.
Passo 3: Cole no Query Validator e valide
Deu certo quando: Aparece Valid Query.
Erro comum: Ignorar a mensagem de campo incompatível e insistir na execução.
Passo 4: Rode sem token dentro de um script, ou pela API com token e OAuth
No script, a função de busca aceita a consulta direto. Pela API, token de desenvolvedor, OAuth e o identificador da MCC quando houver.
Deu certo quando: As linhas voltam com o nome de cada campanha.
Erro comum: Esquecer o identificador da MCC e receber erro de permissão.
Passo 5: Divida o custo por um milhão e confira com a interface
cost_micros vem em milionésimos da moeda.
Deu certo quando: O total bate com a interface no mesmo período.
Erro comum: Apresentar custo um milhão de vezes maior no relatório.
No fim você tem: Uma consulta validada que qualquer script, integração ou agente consegue reaproveitar.

Ver como texto
Tela do Query Validator da Google Ads API com uma consulta GAQL que seleciona nome da campanha, cliques, custo em micros e conversões da tabela campaign nos últimos 30 dias, ordenada por custo, e a mensagem Valid Query.
O servidor MCP oficial da Google Ads API, publicado pelo Google no GitHub, expõe essa mesma consulta a assistentes de IA, em modo somente leitura: listar contas acessíveis, rodar uma busca GAQL e ler os metadados dos recursos. Ele pede o mesmo token de desenvolvedor e o mesmo OAuth. A regra do capítulo continua valendo: pergunta de diagnóstico ao agente, sim; alteração com gasto sem aprovação humana, não. O desenho de um agente com ferramentas e limites está no curso de MCP avançado.
Na segunda-feira, abra a lista de acessos da API e do Editor da sua conta. Revogue toda credencial em nome de quem já saiu, confirme que toda integração fala com a v24 ou mais nova (a v23 sai em fevereiro de 2027) e escreva, para cada automação, o nome de quem aprova a ação dela. O critério de acerto é zero credencial em nome de ex-colaborador. O capítulo da operação de agência transforma essa lista de aprovadores em contrato de operação.
Seu caderno neste capítulo
Abrir o caderno completoSelecione um trecho do capítulo para destacar ou anotar. Nos vídeos e áudios, use Anotar este momento. No teclado, selecione com Shift e as setas e use Alt+Shift+D para destacar ou Alt+Shift+N para anotar.
Salvo neste navegador. Entre na sua conta para levar o caderno a outros aparelhos.
Entre na sua conta para compartilhar o que aprendeu e convidar alguém para estudar com você.
Conexões deste capítulo
Veja o que estudar antes e para onde seguir depois, explore os conceitos e compare abordagens em outros cursos. Sugestões marcadas como “sugerido pelo grafo” vêm dos assuntos em comum, não do índice do curso.
Conceitos deste capítulo
O mesmo assunto em outros cursos
- Meta Ads 2027Fazer onboarding, auditoria e rotina de conta como agência ou equipe internaExaminar conexões de Fazer onboarding, auditoria e rotina de conta como agência ou equipe interna
- LinkedIn Ads: investimento e resultadosUsar automação e planejar a transição do AccelerateExaminar conexões de Usar automação e planejar a transição do Accelerate
- Google Analytics 2027Google Tag Manager: controlar mudanças na medição sem perder o históricoExaminar conexões de Google Tag Manager: controlar mudanças na medição sem perder o histórico
- MCP e Chrome: agentes de IA no navegadorComo entregar uma operação que outra pessoa consegue manterExaminar conexões de Como entregar uma operação que outra pessoa consegue manter
Terminou a leitura?
Você está aqui: capítulo 24 de 26
0 de 26 concluídos
- Próximo · Capítulo 25 de 26 · 15 minOperar como agência: entrada, auditoria e relatório ao donoLer o capítulo 25 sem concluir
Marque como concluído para o capítulo contar no seu painel e no certificado.
- Anterior · Capítulo 23 de 26 · 13 minExperimentos para decidir: escalar, manter, ajustar ou pausarVoltar para o capítulo 23
Leve uma ideia para a prática
Escolha uma atividade no painel e volte a este curso quando quiser.
Atividades e evolução ficam reunidas no painel da sua conta.



