Para ejecutar una consulta GAQL en Google Ads con Claude o ChatGPT, conecta tu cuenta de Google Ads a PaidSync.ai y pide al asistente que ejecute una consulta GAQL, que lee casi cualquier recurso de la cuenta. GAQL es el lenguaje de consultas de Google. La herramienta es de solo lectura, así que una consulta no puede cambiar nada.
Qué herramientas actúan
GAQL es el lenguaje de consultas que hay detrás de los informes de Google Ads. Cuando ningún informe predefinido encaja, Claude puede escribir la consulta y ejecutarla:
run_gaql_queryejecuta cualquier consulta GAQL y es de solo lectura. Puede consultar campañas, grupos de anuncios, anuncios, palabras clave, assets, audiencias, estrategias de puja, experimentos, facturas y eventos de cambio, entre 100 o más recursos.list_accountslista las cuentas de Google Ads que puedes consultar.
run_gaql_query y list_accounts solo leen tu cuenta.
Cómo está construido el flujo
| Herramienta | Qué hace |
|---|---|
| run_gaql_query | Ejecuta la consulta que describes |
| list_accounts | Muestra en qué cuentas puedes ejecutarla |
Una consulta usa SELECT, FROM, WHERE, ORDER BY y LIMIT, por ejemplo SELECT campaign.id, campaign.name FROM campaign. No tienes que escribirla tú. Describe la tabla que quieres y pide al asistente que muestre la consulta que ejecutó para que puedas reutilizarla.
Cómo ejecutar una consulta GAQL en Google Ads con Claude en 5 pasos
Estos pasos usan Claude para ejecutar una consulta GAQL. PaidSync.ai también funciona en ChatGPT y los prompts son los mismos.
Conecta Google Ads a PaidSync.ai
Empieza en paidsync.ai y vincula Google Ads en la pantalla de inicio de sesión de Google. No intervienen ningún developer token ni ningún proyecto de Google Cloud. El acceso que elijas debe llegar a la cuenta donde ejecutarás una consulta GAQL.
Añade PaidSync.ai a Claude
Abre el directorio de conectores de Claude, añade PaidSync.ai e inicia sesión. Pide “lista mis cuentas de Google Ads” y elige la cuenta donde ejecutarás una consulta GAQL.
Describe los datos
Di lo que quieres con palabras sencillas, como campañas pausadas con sus presupuestos, o los términos de búsqueda con más clics.
Revisa la consulta
Pide al asistente que muestre el GAQL que escribió antes de ejecutarlo, para que puedas comprobar los campos y los filtros.
Ejecuta y ajusta
Ejecútala y luego ajusta la consulta con un filtro de fechas o un límite hasta que la tabla sea la que necesitas.
Revisa el resultado
Compara un total de la consulta con el mismo total en Google Ads para una campaña. Si coinciden, puedes fiarte del resto de la tabla.
Usa estos dos prompts para ejecutar una consulta GAQL, en este orden.
Cómo te protege PaidSync.ai
- No se cambia nada.
run_gaql_queryylist_accountssolo leen la cuenta, así que nada de esto edita una campaña. - Solo lectura cuando lo quieras. Una clave de API de PaidSync.ai solo puede leer y mostrar vistas previas en Google Ads, así que
run_gaql_queryylist_accountsfuncionan con una clave que no puede cambiar nada. Los tokens se cifran en reposo.
Todas las herramientas de Google Ads que ofrece PaidSync.ai están en la página del servidor MCP de Google Ads, incluidas las que sirven para ejecutar una consulta GAQL.
Preguntas frecuentes
¿Cómo ejecuto una consulta GAQL en Google Ads?
En Google Ads, abre el generador de consultas o la API y escribe una sentencia GAQL. Con PaidSync.ai, pídeselo a Claude o ChatGPT en lenguaje natural y él escribe y ejecuta la consulta por ti.
¿Puede una consulta GAQL modificar mi cuenta?
No. run_gaql_query es de solo lectura. Los cambios pasan por las herramientas de escritura, que muestran una vista previa primero.
¿Puede ChatGPT ejecutar una consulta GAQL en Google Ads?
Sí. PaidSync.ai conecta Google Ads con ChatGPT y con Claude, y las mismas herramientas funcionan en ambos, así que puedes pedirle una consulta GAQL igual que en Claude.
¿Qué necesito antes de ejecutar una consulta GAQL?
Una cuenta de Google Ads conectada. La consulta se redacta por ti a partir de tu descripción.
¿Cuánto cuesta?
PaidSync.ai es gratis con 100 tareas al mes, por valor de $50, sin tarjeta, lo suficiente para ejecutar una consulta GAQL y ver el resultado. Pro empieza en $99 al mes. Consulta los precios.
Guías relacionadas
PaidSync.ai ofrece 630+ herramientas en 14 plataformas de anuncios y analítica. Conecta tus cuentas una vez y úsalas en el asistente de IA con el que ya trabajas.
Empieza gratis Reserva una demo