Quarta-feira, 10 de dezembro de 2025
Anunciamos o lançamento do Assistente para Desenvolvedores da API Google Ads, uma extensão avançada para a CLI do Gemini criada para simplificar seus fluxos de trabalho da API Google Ads. Com essa ferramenta, você pode interagir com a API Google Ads usando linguagem natural, o que facilita ainda mais receber informações, gerar códigos e até recuperar dados diretamente no seu terminal.
Seja você um desenvolvedor experiente ou novo na API Google Ads, esse assistente pode ajudar você a trabalhar com mais eficiência.
O que ele faz?
O Assistente para Desenvolvedores da API Google Ads (v1.0) aprimora a CLI do Gemini com vários recursos importantes:
- Perguntas e respostas sobre linguagem natural: tem dúvidas sobre a API Google Ads? É só pedir.
- "Quais são os tipos de campanha disponíveis?"
- "Quero saber mais sobre os relatórios das campanhas Performance Max."
- "Como faço para filtrar por data na GAQL?"
- Geração de código com linguagem natural: descreva os dados necessários, e o assistente vai gerar a Linguagem de consulta do Google Ads (GAQL) e o código Python executável usando a biblioteca de cliente
google-ads-pythoncomo contexto para que o código siga as práticas recomendadas.- "Mostre as campanhas com mais conversões nos últimos 30 dias."
- "Get all ad groups for customer '123-456-7890'."
- "Encontre anúncios reprovados em todas as campanhas."
- O código gerado é salvo automaticamente no diretório
saved_code/.
- Execução direta da API: execute os scripts Python gerados diretamente na linha de comando. O assistente vai executar as chamadas de API somente leitura e mostrar os resultados, geralmente formatados como tabelas no terminal.
- Exportação de CSV: precisa salvar seus dados? É fácil exportar os resultados tabulares das chamadas de API para um arquivo CSV. Basta pedir:
- "Salvar os resultados em um arquivo CSV"
- Os arquivos são salvos no diretório
saved_csv/.
Como funciona?
Essa extensão aproveita a capacidade da CLI do Gemini de usar o contexto de arquivos GEMINI.md e configurações em .gemini/settings.json. Ao configurar o assistente com caminhos para o clone da biblioteca google-ads-python local e os diretórios de exemplo, ele fornece uma geração de código relevante e precisa.
Primeiros passos
Confira o que você precisa para começar:
Pré-requisitos:
- Familiaridade com os conceitos e a autenticação da API Google Ads.
- Um token de desenvolvedor da API Google Ads.
- Um arquivo de credenciais
google-ads.yamlconfigurado no diretório principal. - Python >= 3.10.
- A CLI do Gemini instalada.
- Uma cópia local da biblioteca de cliente
google-ads-python. O script de configuração pode clonar isso para você.
Consulte o arquivo README no repositório do GitHub para ver instruções detalhadas de configuração e exemplos.
Onde encontrar
O Assistente para Desenvolvedores da API Google Ads está disponível no GitHub.
Comunidade e suporte
Recomendamos que você teste o recurso. Seu feedback é muito importante e pode ser enviado nesta pesquisa. Participe da discussão no canal #ads-api-ai-tools do nosso Discord.
Use a guia "Issues" do GitHub no repositório para informar bugs, sugerir recursos ou pedir suporte. Confira as diretrizes de contribuição em CONTRIBUTING.md.
Boa codificação!
Marcadores: google-ads-api, release