GAQL

Il linguaggio di interrogazione della Google Ads API, simile a SQL, che nel Google Ads MCP Server è il cuore del tool search.

GAQL (Google Ads Query Language) è il linguaggio di interrogazione della Google Ads API, simile a SQL. Nel Google Ads MCP Server è il cuore del tool search, che esegue query GAQL contro l’account; il tool get_resource_metadata aiuta il modello a scrivere GAQL valido mostrandogli i campi interrogabili di una risorsa.¹

Come funziona

Una query GAQL seleziona campi da una risorsa FROM, come campaign, ad group, keyword o asset, con filtri WHERE su segmenti e ordinamento ORDER BY. Un esempio tipico seleziona nome della campagna, costo, conversioni e costo medio per clic degli ultimi sette giorni.¹

Due proprietà del linguaggio contano in pratica. Il costo è espresso in micros: un milione di micros equivale a un’unità della valuta dell’account, quindi i valori vanno divisi per un milione per avere la valuta corrente. Le date usano intervalli nominati, come LAST_7_DAYS o LAST_30_DAYS, oppure l’intervallo BETWEEN con date esplicite.¹

Perché conta in MCP

Nel Google Ads MCP Server, GAQL rende possibile un design sottile ma potente: un solo tool search risponde a quasi ogni domanda di reporting componendo una query, invece di esporre decine di tool fissi. Il contro è che l’accuratezza della risposta dipende dalla capacità del modello di scrivere GAQL valido: un campo sbagliato o un segmento data mancante produce un errore o, peggio, numeri sbagliati esposti con sicurezza. Da qui l’esistenza di versioni della comunità che aggiungono tool di supporto, come get_gaql_doc e get_reporting_fields_doc, per insegnare al modello lo schema.²

Voci correlate

Google Ads MCP Server — il server dove GAQL è il linguaggio di search
Model Context Protocol — il protocollo che standardizza l’accesso
Primitive MCP — i tool come primitiva del protocollo
Limiti di MCP — l’accuratezza delle query generate come limite
Portale: MCP

Bibliografia e sitografia

Google Developers, Google Ads MCP server: Developer integration guide, 3 agosto 2026. developers.google.com
Soku, Google Ads MCP: The Complete Guide (2026), 8 giugno 2026. soku.ai