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.
Scope: read token (or higher). Read-only.
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). Required with an org-scoped token for account-scoped tools — call gads_list_ad_accounts to enumerate accounts. Omit with a project-scoped token. |