Google Ads 2027 · Capítulo 23 de 25 · 16 min
Delegar ao Ask Advisor, scripts e API com aprovação humana
A rotina repetitiva sai da mão do gestor e a decisão com gasto fica com uma pessoa que assina, em cada uma das quatro camadas de automação.
Este capítulo faz parte do curso gratuito Google Ads 2027.
Com a decisão de escalar, manter ou pausar tomada por experimento, sobra a pergunta de quem executa o trabalho repetitivo. A conta da Aurora Casa gera dezenas de ajustes pequenos por semana: pausar termo ruim, subir orçamento em campanha limitada, conferir se a conversão parou de chegar. Renata fazia tudo à mão e perdia a parte que rende, que é decidir.
Delegar sem controle custa em duas direções. Um script que pausa campanha por CPA alto num dia em que a conversão ainda não chegou derruba a venda de sábado. Um agente que cria campanha sozinho a partir de um pedido em linguagem natural gasta antes de alguém revisar. A automação certa tira a mão da rotina e mantém a assinatura na decisão.
Quatro camadas de delegação existem em setembro de 2026: o Ask Advisor e o Ads Advisor, o Google Ads Editor, os scripts e a Google Ads API, com a Data Manager API ao lado. Cada camada entra aqui com o que faz, o que exige de acesso e o ponto exato em que uma pessoa aprova.
Se a figura ultrapassar a área visível, deslize para os lados. Pelo teclado, foque a figura e use as setas.
Ask Advisor: o agente com Gemini que responde e age sobre Google Ads e Google Analytics numa conversa. Anunciado no Google Marketing Live de 20 de maio de 2026, ele mantém o contexto entre tarefas, cria campanhas a partir de um pedido em linguagem natural com dados do Merchant Center e cruza dados de Ads e Analytics para gerar diagnósticos. O Merchant Center entra na conversa em breve, segundo o post oficial.
O status pede leitura fria. O Ask Advisor está em beta, para contas em inglês, com rollout previsto pelo Google para o fim de 2026. Uma conta operada em português, como a da Aurora, não tem o agente hoje e não tem data anunciada para tê-lo. Quem quiser experimentar precisa de uma conta em inglês, e mesmo nela o acesso chega em ondas.

Se a figura ultrapassar a área visível, deslize para os lados. Pelo teclado, foque a figura e use as setas.
Ads Advisor: o assistente que já existe dentro do Google Ads para contas em inglês no mundo todo. Na mesma data o Google anunciou três recursos agênticos de segurança para os meses seguintes: solução proativa de violação de política, monitoramento de segurança 24 horas com painel e passkeys, além de certificações instantâneas via Gemini. Nenhum dos três tinha data para contas em português em setembro de 2026.
O mesmo evento mostrou o outro lado do agente, dentro do anúncio. Conversational Discovery ads, com criativo gerado pelo Gemini para a pergunta feita; Highlighted Answers, o anúncio recomendado nas listas do AI Mode; AI-powered Shopping ads; Business Agent for Leads, o agente de marca que conversa no lugar do formulário; Direct Offers. Tudo em teste nos Estados Unidos, e o rumo é claro: agente na conta e no anúncio.
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. Pedir ao agente por que o CPA da campanha de planejados subiu na semana passada rende uma hipótese em segundos. Deixar que ele crie a campanha nova e a publique 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
Google Ads Editor: o aplicativo de mesa que baixa a conta, edita em massa sem conexão e publica tudo de uma vez. A versão 2.13, com a atualização 2.13.2 em 24 de julho de 2026, trouxe a meta de retenção no Performance Max e o canal Maps no Demand Gen. Trouxe também campos de nome e logo em vídeo responsivo, AI Max para Shopping, o campo de atestado de IA e relatórios por canal, e removeu a criação de Video Action Campaigns.
O fluxo do Editor tem cinco etapas e a quarta é a que salva a conta. Baixar a conta; editar em massa, com localizar e substituir; importar uma planilha CSV com campanhas e palavras novas; revisar a lista de alterações, onde o Editor marca erro de política e campo vazio; publicar. Quem publica sem abrir a lista de alterações descobre o erro no dia seguinte, no relatório de reprovações.
Se a figura ultrapassar a área visível, deslize para os lados. Pelo teclado, foque a figura e use as setas.
Renata usou o Editor para dois trabalhos que levariam uma tarde na interface. Renomeou 38 campanhas para a nomenclatura do capítulo 4 e acrescentou 214 palavras negativas em seis campanhas de Pesquisa, tudo em 40 minutos, com a lista de alterações revisada por ela antes de publicar. A versão 2.12, de março de 2026, já aceitava 15 vídeos por grupo de ativos e orçamentos totais de campanha.
Scripts: código em JavaScript que roda dentro da conta em horário marcado, lê relatórios e altera campanhas. O Google não publicou novidade específica de scripts em 2026, e a mudança que os alcança é a de autenticação, descrita adiante. Os quatro usos que pagam o esforço são alerta de orçamento e de CPA, pausa condicionada, detecção de anomalia e relatório automático por e-mail.
Os quatro scripts da Aurora Casa, com o poder que cada um tem
| 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 | Renata 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.
Google Ads API: a interface por onde um sistema externo lê relatórios, cria campanhas e envia conversões sem tocar na tela. Ela fala uma linguagem de consulta própria, o GAQL, e exige um token de desenvolvedor, uma conta de administrador e credenciais OAuth. A versão v25 saiu em 22 de julho de 2026, com a meta de retenção por fidelidade e relatórios de YouTube por duração; a v25.1 veio em 19 de agosto.
O calendário de versões é o que quebra integração silenciosamente. O Google lança uma versão principal a cada quatro meses, mais ou menos, e sustenta cada uma por cerca de doze. A v21 saiu do ar em agosto de 2026, a v22 sai em 7 de outubro de 2026, a v23 em fevereiro de 2027 e a v25 tem saída prevista para agosto de 2027. Integração parada numa versão morta para de responder no dia do encerramento.
Datas que mexem na automação da conta, de junho de 2026 a agosto de 2027
- 15/06/2026Concluído
API deixa de aceitar novos adotantes de importação offline
Erro CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE; integrações existentes seguem
- 22/07/2026Concluído
Google Ads API v25
Meta de retenção por fidelidade; sai CustomerLifecycleGoal
- 24/07/2026Concluído
Google Ads Editor 2.13.2
AI Max para Shopping, atestado de IA, relatórios por canal
- 05/08/2026Concluído
Passkey obrigatório para novo refresh token
Vale para Editor, scripts, BigQuery Data Transfer e Looker Studio
- 10/09/2026Agora
Data Manager API adota o padrão ECAPI
Mesmo dia da métrica Data Strength Uplift e da nova experiência de onboarding da API
- 07/10/2026Previsto
Encerramento da v22
Integração na v22 para de responder
- fev/2027Previsto
Encerramento da v23
Próxima parada obrigatória de migração
- ago/2027Previsto
Encerramento previsto da v25
Política de cerca de 12 meses de suporte por versão
Autenticação mudou em 5 de agosto de 2026. Desde essa data, gerar um novo refresh token OAuth da API exige passkey; senha com segundo fator por SMS ou aplicativo deixou de valer nessa etapa. Tokens já emitidos continuam funcionando e contas de serviço estão isentas. A regra alcança o Editor, os scripts, o BigQuery Data Transfer e o Looker Studio, porque todos passam pelo mesmo OAuth.
Conversões pela API ganharam uma porta fechada. Desde 15 de junho de 2026 a Google Ads API não aceita novos adotantes de importação de conversão offline nem de Enhanced Conversions for Leads; o pedido volta com o erro CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE. Quem já usava entre dezembro de 2025 e maio de 2026 segue na lista enquanto migra. Conectores de CRM e configurações por tag não foram afetados.
Data Manager API: a interface que substitui aquela porta e leva o dado de primeira parte ao Google Ads. Disponível a todos desde dezembro de 2025, ganhou em 7 de maio de 2026 a versão 1.6, com vendas em loja física e eventos do GA4 com transaction_id. Em 28 de maio veio a 1.7, com conversões offline para CM360 e SA360, e em 30 de julho a remoção de membros de público. Em 10 de setembro adotou o padrão ECAPI do IAB Tech Lab, o que deixa parceiros como Zapier e Stape falarem a mesma língua.
Se a figura ultrapassar a área visível, deslize para os lados. Pelo teclado, foque a figura e use as setas.
Governança da API cabe em três perguntas: quem detém o token, o que ele pode alterar e onde fica o registro. Um token em nome de um desenvolvedor que já saiu é uma porta aberta com passkey de outra pessoa. O piloto de acesso seguro a contas de administrador via API, de 3 de agosto de 2026, mostra que o Google caminha para restringir esse acesso, e a documentação da conta precisa chegar antes dele.
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 compartilham o mesmo defeito quando ninguém assina: a conta muda por conta própria e a explicação chega depois da fatura. Automação que só avisa é lenta; automação que age sem registro é cara.

Se a figura ultrapassar a área visível, deslize para os lados. Pelo teclado, foque a figura e use as setas.
A Aurora fez a limpeza em uma semana. A integração com o RD Station, montada no capítulo 8 por um conector, seguiu enviando 96 leads qualificados por mês sem tocar na API. Um relatório de custo escrito por um desenvolvedor externo em 2025 falava com a v22 e pararia em 7 de outubro. Ele migrou para a v25, e o token antigo, em nome dele, foi revogado e reemitido em nome da empresa, com passkey de Renata.
O resultado prático foi tempo. Renata passou de seis horas semanais de rotina para duas, e as quatro horas voltaram para experimentos e criativo, que são o trabalho que move CPA e ROAS. Nenhum script pausou campanha no período, e o alerta de CPA disparou duas vezes: uma por atraso do CRM, outra por um termo que virou negativa no mesmo dia.
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.

Se a figura ultrapassar a área visível, deslize para os lados. Pelo teclado, foque a figura e use as setas.

Se a figura ultrapassar a área visível, deslize para os lados. Pelo teclado, foque a figura e use as setas.
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.

Se a figura ultrapassar a área visível, deslize para os lados. Pelo teclado, foque a figura e use as setas.
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.
Abra a lista de acessos da API e do Editor da sua conta ainda hoje. Revogue qualquer token em nome de quem já saiu, confirme que toda integração fala com a v25 antes de 7 de outubro de 2026 e escreva, para cada automação, o nome de quem aprova a ação dela. Essa lista de aprovadores é o primeiro documento que o próximo capítulo transforma 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.
Estude antes
- Cobre no relatório os números certos e ignore o restosugerido pelo grafoApresenta os conceitos “Looker Studio” e “BigQuery”, usados em “Delegar ao Ask Advisor, scripts e API com aprovação humana”.
- CursoTikTok Ads e Live Commerce 2027sugerido pelo grafo3 capítulos de “Google Ads 2027” usam conceitos apresentados em “TikTok Ads e Live Commerce 2027”.
Depois, siga para
- CursoGoogle Analytics 2027sugerido pelo grafo4 capítulos de “Google Analytics 2027” usam conceitos apresentados em “Google Ads 2027”.
- CursoCRO: Otimização de Conversão e Experimentaçãosugerido pelo grafo3 capítulos de “CRO: Otimização de Conversão e Experimentação” usam conceitos apresentados em “Google Ads 2027”.
Conceitos deste capítulo
O mesmo assunto em outros cursos
- Meta Ads 2027Automatizar alertas e relatórios com regras, assistente de IA e Marketing APIExaminar conexões de Automatizar alertas e relatórios com regras, assistente de IA e Marketing API
- Google Analytics 2027Entregar o projeto de mensuração e manter a rotina que o conservaExaminar conexões de Entregar o projeto de mensuração e manter a rotina que o conserva
- Agentes de IA Autônomos: Do Conceito à ProduçãoClaude Agent SDKExaminar conexões de Claude Agent SDK
- Python: Programação do ZeroPython no marketing, caso 2: relatório do GA4 por canal com a Data APIExaminar conexões de Python no marketing, caso 2: relatório do GA4 por canal com a Data API
Voltar ao capítulo anterior: Desenhar experimentos e decidir escalar, manter, ajustar ou pausar
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.
Capítulos vizinhos em Google Ads 2027
- 21Montar a rotina diária, semanal e mensal que diagnostica antes de mexer
- 22Desenhar experimentos e decidir escalar, manter, ajustar ou pausar
- 23Delegar ao Ask Advisor, scripts e API com aprovação humana
- 24Fazer onboarding, auditoria e prestação de contas como agência
- 25Lançar a conta inteira e otimizar os primeiros 30 dias