Para executar uma consulta GAQL no Google Ads com o Claude ou o ChatGPT, conecte sua conta do Google Ads ao PaidSync.ai e peça ao assistente para executar uma consulta GAQL, que lê quase qualquer recurso da conta. GAQL é a linguagem de consulta do Google. A ferramenta é somente leitura, então uma consulta não pode alterar nada.
Quem faz o trabalho
GAQL é a linguagem de consulta por trás dos relatórios do Google Ads. Quando nenhum relatório pronto atende, o Claude pode escrever a consulta e executá-la:
run_gaql_queryexecuta qualquer consulta GAQL e é somente leitura. Ela pode consultar campanhas, grupos de anúncios, anúncios, palavras-chave, assets, públicos, estratégias de lances, experimentos, faturas e eventos de alteração, entre 100 ou mais recursos.list_accountslista as contas do Google Ads que você pode consultar.
run_gaql_query e list_accounts apenas leem sua conta.
Como o fluxo é construído
| Ferramenta | O que faz |
|---|---|
| run_gaql_query | Executa a consulta que você descreve |
| list_accounts | Mostra em quais contas você pode executá-la |
Uma consulta usa SELECT, FROM, WHERE, ORDER BY e LIMIT, por exemplo SELECT campaign.id, campaign.name FROM campaign. Você não precisa escrevê-la sozinho. Descreva a tabela que quer e peça ao assistente para mostrar a consulta executada, para você reutilizá-la.
Como executar uma consulta GAQL no Google Ads com o Claude em 5 passos
Estes passos usam o Claude para executar uma consulta GAQL. O PaidSync.ai também funciona no ChatGPT, e os prompts são os mesmos.
Conecte o Google Ads ao PaidSync.ai
Comece em paidsync.ai e conecte o Google Ads pela tela de login do próprio Google. Não há token de desenvolvedor nem projeto no Google Cloud. O login escolhido precisa acessar a conta em que você vai executar uma consulta GAQL.
Adicione a PaidSync.ai ao Claude
Abra o diretório de conectores do Claude, adicione o PaidSync.ai e faça login. Peça “listar minhas contas do Google Ads” e escolha a conta em que vai executar uma consulta GAQL.
Descreva os dados
Diga o que você quer em palavras simples, como campanhas pausadas com seus orçamentos ou os principais termos de pesquisa por cliques.
Revise a consulta
Peça ao assistente para mostrar o GAQL que ele escreveu antes de executá-lo, para você conferir os campos e os filtros.
Execute e refine
Execute e depois refine a consulta com um filtro de data ou um limite até a tabela ser o que você precisa.
Como conferir o resultado
Compare um total da consulta com o mesmo total no Google Ads para uma campanha. Se coincidirem, você pode confiar no resto da tabela.
Use estes dois prompts para executar uma consulta GAQL, nesta ordem.
Como o PaidSync.ai protege você
- Nada é alterado.
run_gaql_queryelist_accountsapenas leem a conta, então nada aqui edita uma campanha. - Somente leitura quando você quiser. Uma chave de API do PaidSync.ai só pode ler e mostrar prévia no Google Ads, então
run_gaql_queryelist_accountsfuncionam com uma chave que não consegue alterar nada. Os tokens são criptografados em repouso.
Todas as ferramentas do Google Ads que o PaidSync.ai oferece estão na página do servidor MCP do Google Ads, incluindo as usadas para executar uma consulta GAQL.
Perguntas frequentes
Como executar uma consulta GAQL no Google Ads?
No Google Ads, abra o criador de consultas ou a API e escreva uma instrução GAQL. Com o PaidSync.ai, peça ao Claude ou ao ChatGPT em português simples, e ele escreve e executa a consulta para você.
Uma consulta GAQL pode alterar minha conta?
Não. run_gaql_query é somente leitura. As alterações passam pelas ferramentas de escrita, que mostram uma prévia primeiro.
O ChatGPT pode executar uma consulta GAQL no Google Ads?
Sim. O PaidSync.ai conecta o Google Ads ao ChatGPT e ao Claude, e as mesmas ferramentas funcionam nos dois, então você pode pedir para executar uma consulta GAQL do mesmo jeito que faria no Claude.
O que preciso antes de executar uma consulta GAQL?
Uma conta do Google Ads conectada. A consulta é escrita para você a partir da sua descrição.
Quanto custa?
O PaidSync.ai é gratuito para 100 tarefas por mês, no valor de $50, sem cartão, o suficiente para executar uma consulta GAQL e ver o resultado. O Pro começa em $99 por mês. Veja os preços.
Guias relacionados
O PaidSync.ai roda 630+ ferramentas em 14 plataformas de anúncios e análise. Conecte suas contas uma vez e use-as no assistente de IA em que você já trabalha.
Comece grátis Ver demo