Apresentamos o Assistente para Desenvolvedores da API Google Ads v2.0

Quinta-feira, 26 de fevereiro de 2026

Essa atualização importante transforma o Assistant de uma ferramenta poderosa de geração de código em um parceiro proativo de solução de problemas e automação para desenvolvedores do Google Ads. Desde o lançamento da versão 1.6.0, ouvimos seu feedback e nos concentramos nas partes mais desafiadoras do desenvolvimento de APIs: diagnóstico, consistência e configuração.

O que há de novo na v2.0?

1. Instalação e manutenção mais simples

Configurar um ambiente de desenvolvimento multilíngue não precisa ser uma tarefa difícil.

  • Configuração com um comando: use a nova flag --install-deps com install.sh ou install.ps1 para processar as dependências do pip, do composer e do bundler de uma só vez.
  • Estrutura de diretório unificada: todo o código gerado, as exportações de CSV e os relatórios de diagnóstico agora estão organizados em um único diretório saved/ com subdiretórios para cada tipo de saída.
  • Atualização com um comando: quando uma nova versão da API e das bibliotecas de cliente é lançada, você precisa executar update.sh para trabalhar com a versão mais recente. Também é possível usar update.sh para adicionar outras bibliotecas de cliente ao contexto.

2. Solução de problemas de conversão agêntica

O rastreamento de conversões off-line é um dos recursos mais eficientes e complexos da API Google Ads. Descobrir por que uma conversão não foi atribuída pode ser um processo manual demorado.

Na v2.0, apresentamos um pacote dedicado de solução de problemas e diagnóstico de conversões.

  • Novo script: api_examples/collect_conversions_troubleshooting_data.py
  • Novo comando: /conversions_support_data

O script executa relatórios padrão para resolver problemas de conversões e fornece contexto para o Assistente resolver seus problemas.

O comando é mais útil depois que o Assistente analisa o problema de conversão e tenta resolvê-lo. Se não for possível e você precisar entrar em contato com o suporte, esse comando vai analisar as configurações do cliente, as ações de conversão e os resumos de upload para gerar um relatório de diagnóstico estruturado com base na análise já realizada. Ele até identifica estados "não íntegros" e altas taxas de falha automaticamente, poupando horas de análise de registros. Ele salva os resultados em um arquivo de texto que pode ser incluído em uma solicitação de suporte, se necessário.

3. Criado para a API mais recente (v23)

A versão 2.0 é totalmente compatível com a API Google Ads v23. Todos os nossos exemplos interativos foram atualizados, e o contexto interno do assistente agora está otimizado para os recursos e campos mais recentes, garantindo que o código gerado esteja pronto para produção.

4. Automação integrada com hooks de sessão

Adicionamos os hooks SessionStart e SessionEnd para que seu fluxo de trabalho seja realmente simples.

  • Configuração automática: o Assistente agora pode localizar automaticamente seu arquivo de configuração no diretório $HOME no início de uma sessão. Ele é copiado para o subdiretório config no diretório do projeto. O Python é a linguagem preferida do Gemini para consultar a API. Portanto, se você estiver usando outro idioma, ele vai ler seu arquivo de configuração e criar um google-ads.yaml temporário em config para as consultas, mas vai continuar respondendo no código do idioma de sua preferência.
  • Limpeza automática: as configurações temporárias são apagadas com segurança quando você sai, mantendo seu espaço de trabalho limpo e suas credenciais seguras.

5. Validação mais inteligente da GAQL

Criar consultas complexas da GAQL está mais fácil do que nunca. Atualizamos GEMINI.md e conversions/GEMINI.md com regras de validação rigorosas para os casos extremos mais recentes da API, incluindo um melhor processamento de segmentos de data e requisitos de intervalo finito. O Assistente agora detecta erros de lógica antes de você executar a consulta.

6. Habilidades

Pense em uma habilidade como um miniplug-in ou um "modelo de comportamento". Enquanto o contexto geral (como o arquivo GEMINI.md) fornece informações de base, uma habilidade só é "carregada" no cérebro da IA quando ela precisa especificamente realizar uma tarefa complexa e processual, como obter a versão atual desta extensão. Você não executa a habilidade diretamente. O Gemini decide quando precisa delas.

Embora ainda seja um recurso experimental, incluímos um nesta versão para complementar o uso de hooks para inicialização e limpeza de sessões.

Por que fazer upgrade?

O salto da v1.6.0 para a v2.0.0 não é apenas sobre novos recursos, mas também sobre confiabilidade. Ao integrar o conhecimento profundo da API com ferramentas de diagnóstico automatizadas, a v2.0 reduz o ciclo de "tentativa e erro" que costuma atrasar a integração da API.

Seja para depurar uploads de conversões ou criar pipelines de relatórios complexos, a v2.0 oferece as ferramentas para trabalhar com mais rapidez e confiança.

Primeiros passos

Primeira instalação

Como fazer upgrade de uma versão anterior

  • Copie qualquer código personalizado de saved_code/ e saved_csv/ para um local seguro.
  • Exclua o clone local do Assistente para Desenvolvedores da API Google Ads excluindo o diretório do projeto e todos os subdiretórios e arquivos.
  • git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  • No diretório do projeto, execute install.sh ou install.ps1 para instalar a extensão e as bibliotecas de cliente.

Bob Hancock, equipe da API Google Ads

Marcadores: google-ads-api, release