Google Ads Query (GAQL)

Runs ANY read-only Google Ads Query Language (GAQL) SELECT against a connected Google Ads account and returns the raw rows — the escape hatch for data no other tool exposes: any resource (campaign, ad_group, ad_group_ad, ad_group_criterion, keyword_view, search_term_view, change_event, change_status, asset, conversion_action, customer_client, bidding_strategy, geographic_view, user_location_view, landing_page_view, recommendation, ...), any metric and any segment the Google Ads API supports. GAQL can only READ; it cannot change the account. Reference: https://developers.google.com/google-ads/api/docs/query/overview and the field list per resource at https://developers.google.com/google-ads/api/fields (for the API version this server runs; field names occasionally change between versions, campaign.start_date_time being one). Rules: a query starts with SELECT; metrics need a date filter or segments.date range for meaningful periods (WHERE segments.date DURING LAST_30_DAYS); money fields are in micros (÷1,000,000, account currency). list_entities / get_report return normalised statuses (is_serving) and currencies for the common questions. limit = rows to return in this response (no upper bound; 0 or empty = as many as fit in one response, about 380 KB). Every row the query matches is kept: total_rows is the full count, and when has_more is true, call again with page_token=next_page_token (query not needed) to get the next rows at no credit cost. customer_id empty = the default connected account.