Reads
gads_run_gaql_query
Run a read-only GAQL query against the LIVE Google Ads API for data not warehoused (e.g.
Run a read-only GAQL query against the LIVE Google Ads API for data not warehoused (e.g. today's numbers or an unusual segmentation). SELECT only. Known enum fields come back as labels (MOBILE, not 4) and *_micros fields as account-currency units. Row count is governed by limit/offset (any LIMIT in the query is rewritten) — when truncated is true, re-call with a higher offset. Use the warehoused tools first for standard performance.
Type: read-only. Never changes the account.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | |
purpose | string | Yes | |
limit | integer | No | (default: 100) |
offset | integer | No | Rows to skip (client-side page window over the first 1000 rows). (default: 0) |
projectId | string | No | Target account (project id). Optional when exactly one authorized stored account exists. Use gads_list_ad_accounts or gads_get_connection_status to select among multiple accounts. |