Execute a custom GAQL query against a Google Ads account, paginated.
Power-user tool for queries the convenience tools don't cover. Prefer
google_ads_account_performance, google_ads_campaign_performance,
google_ads_daily_trends, google_ads_conversion_performance, or
google_ads_search_terms when they fit — they return cleaner shaped data.
Use this for ad-group/keyword/asset/criterion-level queries, custom
segmentation, or anything not covered by those.
Prerequisites: if you don't know the GAQL syntax, call google_ads_gaql_doc
first. For field names of a specific view, call google_ads_reporting_view_doc.
Sensitive billing/access resources are not queryable here.
Returns up to `page_size` rows (default 200, max 1000) plus
`next_page_token` for the next page. The user usually wants the full
picture for analysis — keep calling with the returned token until
next_page_token is null. MCC login_customer_id is auto-detected if
omitted. When paginating, pass the SAME query and customer_id back with
page_token from the prior response.
Args:
query: The GAQL query to execute.
customer_id: The Google Ads customer ID (digits only).
login_customer_id: Optional MCC account ID. Auto-detected if omitted.
page_size: Rows per page (1-1000, default 200).
page_token: Opaque cursor from a prior response. Omit on first call.
ConnectorOAuth
