Terça-feira, 25 de agosto de 2026
Uma versão principal do Assistente para desenvolvedores da API Google Ads já está disponível. Nesta versão, o assistente deixa de ser um projeto independente e passa a ter uma arquitetura de plug-in unificada, projetada para integrar recursos especializados da API Google Ads diretamente aos fluxos de trabalho dos agentes de IA.
O que é?
O Assistente para Desenvolvedores da API Google Ads traz um conhecimento profundo do domínio do Google Ads para ambientes de programação de IA, como o Antigravity e o Claude Code. Ele equipa seu assistente de IA com ferramentas e proteções especializadas. As funções incluem:
- Gerar código idiomático: crie códigos de integração testados e com as práticas recomendadas em Python, Java, PHP, .NET e Ruby.
- Validar consultas GAQL: verifica automaticamente a sintaxe, a compatibilidade de campos, a segmentação por data e as regras de zero impressão antes de executar consultas.
- Inspecionar esquemas do Protobuf: descoberta sob demanda de campos de recursos, tipos de dados e definições de tipo enumerado para qualquer versão ativa da API Google Ads para garantir que os campos de consulta da GAQL sejam válidos.
- Resolver problemas da API: diagnostique falhas no upload de conversões off-line, navegue pelas hierarquias das contas de administrador e crie filtros de listagem das campanhas Performance Max. Você pode fazer perguntas em linguagem natural, como "Mostre todos os anúncios com problemas na minha conta e recomende como corrigi-los".
- Responder a perguntas sobre a API: o assistente responde a perguntas combinando regras de arquitetura incorporadas da API Google Ads com inspeção dinâmica e local do esquema Protobuf para oferecer orientações precisas sobre a versão e snippets de código verificados. Ele baseia as respostas diretamente em definições oficiais de APIs e no código-fonte de bibliotecas de cliente, em vez de depender apenas do treinamento geral do modelo. Por exemplo, "O que é um conjunto compartilhado e como usá-lo?"
- Relatórios ad hoc: você pode pedir dados de performance em inglês simples, e o assistente cria, valida e executa instantaneamente as consultas GAQL necessárias diretamente na sua conta do Google Ads. Ele transmite os resultados em tempo real para o chat em tabelas limpas e formatadas, facilitando a criação de relatórios específicos e a investigação de métricas. Se quiser salvar os resultados, peça para "Salvar os resultados como um arquivo CSV em <seu diretório>". Depois, você poderá carregar o arquivo em uma planilha para análise.
Suporte para Antigravity e Claude Code
Esta versão apresenta suporte para duas plataformas:
- Antigravity: suporte nativo para ambientes de desenvolvimento do Antigravity com registro de plug-ins global e de espaço de trabalho.
- Claude Code: integração total com o sistema de plug-ins da CLI do Claude Code, incluindo comandos de barra personalizados (como
/validate-gaql,/inspect-object,/troubleshoot-conversionse/get-cids).
Os scripts de instalação unificados estão disponíveis para Linux, macOS (bash) e Windows (PowerShell) para fornecer um gerenciamento de ciclo de vida consistente nas três plataformas.
Desempenho aprimorado
- Redução do consumo de tokens: a divulgação progressiva de regras e esquemas carrega apenas o contexto necessário para uma determinada tarefa, reduzindo a sobrecarga de tokens de comando.
- Tempos de resposta mais rápidos: a execução de habilidades sob demanda e o roteamento de comandos direcionados aceleram a conclusão de tarefas de ponta a ponta.
- Menor uso da CPU: os pipelines de execução simplificados eliminam a sobrecarga de processos em segundo plano durante as sessões de desenvolvimento.
- Redução de E/S de disco: reduzir o número de arquivos desnecessários na árvore de plug-ins impede que observadores de arquivos, linters e indexadores de ambiente de desenvolvimento integrado verifiquem dezenas de milhares de arquivos protobuf/SDK não utilizados.
- Menor consumo de memória (RAM) e zero sobrecarga de daemon: as habilidades e os comandos agora são executados de forma temporária como processos filhos rápidos apenas quando chamados, reduzindo o uso de recursos do sistema a zero quando ocioso.
- Versão da API em cache e resolução de esquema do Protobuf: o assistente evita fazer chamadas repetitivas de API de reflexão ou metadados remotos ao inspecionar campos, recursos e tipos enumerados padrão.
- Execução de comandos determinística x raciocínio de LLM multiturno: em vez de o LLM adivinhar ou depurar iterativamente a sintaxe da GAQL em 3 a 4 idas e voltas, o validador local verifica campos, recursos, métricas de zero impressões e cláusulas de data em uma única etapa.
Uma versão principal criada em uma arquitetura de plug-in moderna
Esta é uma versão principal que não é compatível com as anteriores. As versões anteriores dependiam de uma estrutura de projeto de espaço de trabalho local. Essa versão é criada em uma arquitetura de plug-in padronizada que é instalada para ficar disponível globalmente.
Modularizar regras, habilidades e comandos de diagnóstico em um pacote de plug-ins independente permite que os desenvolvedores instalem, atualizem e gerenciem o assistente em vários ambientes e projetos.
Consulte o arquivo README.md para ver detalhes técnicos sobre a arquitetura do plug-in.
Primeiros passos
Devido às mudanças de arquitetura nesta versão, consulte a documentação antes da instalação:
- Leia README_BEFORE_INSTALLATION.md para saber mais sobre os pré-requisitos e a preparação do ambiente.
- Siga as instruções de instalação em README.md.
Queremos saber sua opinião
Compartilhe seu feedback, informe problemas e sugira recursos usando o formulário de pesquisa:
Marcadores: google-ads-api, release