Apresentamos o Assistente para Desenvolvedores da API Google Ads v3.0.0

Quarta-feira, 10 de junho de 2026

Temos o prazer de anunciar o lançamento da v3.0.0 do Assistente para Desenvolvedores da API Google Ads. Esta versão principal é um marco significativo na evolução do Assistente, com foco na modernização da arquitetura, na melhoria da confiabilidade e em um design mais modular.

Com esta versão, estamos migrando o assistente para o framework de agentes do Google Antigravity e fazendo a transição para uma arquitetura baseada em habilidades. Essas mudanças tornam o Assistente mais robusto, facilitam a manutenção e reduzem o uso de tokens.

Novidades da v3.0.0

1. Com tecnologia do framework Antigravity

O Assistente para Desenvolvedores da API Google Ads migrou do gemini-cli para o framework de agente Antigravity (v3.0.0). Esse upgrade do framework oferece um ambiente de execução mais estruturado e confiável. Além disso, a estrutura de diretórios e arquivos do projeto foi atualizada para ser totalmente compatível com o Antigravity.

O suporte para o gemini-cli será encerrado em 18 de junho de 2026, conforme detalhado neste comunicado do blog do Google.

2. Uma arquitetura modular baseada em habilidades

As principais funcionalidades do Assistente agora são chamadas de Habilidades. Em vez de depender de instruções amplas e não estruturadas em um arquivo de contexto, o assistente agora carrega diretórios de ferramentas especializados e testados (habilidades) de forma dinâmica quando necessário. Isso reduz drasticamente as "alucinações" e garante que as tarefas sejam executadas usando procedimentos precisos e verificados.

As principais atualizações nessa transição modular incluem:

  • Validação da GAQL (validate_gaql): movida para uma habilidade dedicada. Agora, ele inclui verificações de consulta estática aprimoradas para segmentos de data, filtros de um único dia de click_view e limites de change_status.
  • Resolver problemas de conversões (troubleshoot_conversions): substitui o antigo conversions_support_package. Ele consolida todos os scripts de solução de problemas de conversão e resumo de upload, além de testes, em um único diretório de habilidades coeso.
  • Comandos estruturados (explain e step_by_step): convertidos em habilidades para aplicar layouts consistentes e estruturados para explicações.
  • Novo mapeamento de contas (get_cids_under_mcc): uma nova habilidade para recuperar todas as contas secundárias em uma conta de administrador (MCC).
  • Nova inspeção de objetos (inspect_object): uma nova habilidade para pesquisar dinamicamente mensagens e tipos enumerados do Protobuf, ajudando a garantir que o Assistente sempre use as estruturas corretas.
  • Novo filtro de listagem de Performance Max (pmax_listing_filter): uma nova habilidade para padronizar as modificações na árvore de exclusão de páginas da Web do grupo de produtos anunciados para campanhas Performance Max.

3. Mais consistência e rigor

Introduzimos regras e requisitos mais rígidos para garantir a geração de código e a validação de consultas de alta qualidade:

  • Controle de versões explícito da API: habilidades críticas como get_cids_under_mcc, validate_gaql e troubleshoot_conversions agora exigem um argumento api_version explícito, eliminando ambiguidades.
  • Regras estritas da GAQL:
    • Adicionamos uma regra ao AGENTS.md para impedir o uso de funções de agregação SQL (como SUM, COUNT e AVG) em consultas da GAQL, já que elas não são compatíveis.
    • Adicionamos uma regra para verificar primeiro as notas da versão do site para desenvolvedores da API Google Ads em busca da versão atual da API, garantindo que o Assistente use a documentação atualizada.
    • Configuração simplificada: o AGENTS.md foi simplificado, o que resultou em uma janela de contexto inicial menor. A documentação de conversão duplicada foi removida em favor das habilidades programáticas.

4. Melhorias na experiência do desenvolvedor (DX)

Fizemos várias melhorias de qualidade de vida para tornar o ciclo de desenvolvimento mais rápido e simples:

  • Ambiente virtual persistente (.venv): o ambiente virtual não é mais excluído ao final de uma sessão. Na inicialização, o Assistente verifica a versão do Python do sistema. Ele só recria o .venv se uma versão mais recente do Python estiver disponível.
  • Armazenamento em cache inteligente da versão da API: o Assistente agora armazena em cache a versão atual da API Google Ads com um TTL de 19 horas, reduzindo o tempo de inicialização ao evitar verificações de rede redundantes.
  • Melhor depuração com registros persistentes: as mensagens de registro agora incluem carimbos de data/hora. O arquivo de registro é gravado no diretório .agents/ e não é mais redefinido a cada execução, preservando o histórico para solução de problemas.

Por que fazer upgrade?

O upgrade para a v3.0.0 é principalmente sobre confiabilidade e estrutura. Ao migrar para o framework Antigravity e modularizar os recursos em Skills, tornamos o Google Assistente mais previsível e eficiente em termos de recursos.

Se você quiser uma inicialização mais rápida, uma validação de GAQL mais confiável e uma experiência de solução de problemas mais robusta, recomendamos fazer upgrade para a v3.0.0.

Começar

Primeira instalação

  1. Instale a CLI do Antigravity: siga as instruções em https://antigravity.google/.
  2. Clone o assistente: 
    git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  3. Execute o script de instalação:
    • Linux/macOS: execute ./install.sh (o padrão é o suporte ao Python, use flags como --php ou --ruby para outras linguagens).
    • Windows: abra o PowerShell e execute .\install.ps1.

Fazer upgrade da v2.x

  1. Copie qualquer código ou dado personalizado de saved/ para um local seguro fora do diretório do projeto.
  2. Exclua o clone local do Assistente.
  3. Clone o repositório:
git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  1. Execute o script de instalação (install.sh ou install.ps1) para inicializar o novo ambiente do Antigravity.

Bob Hancock, Equipe de API Google Ads

Marcadores: google-ads-api, release