Google Ads Query (GAQL)
google_ads_queryRuns 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 (use the version this server runs; field names occasionally change between API versions, e.g. campaign.start_date_time). Rules: start with SELECT; metrics need a date filter or segments.date range for meaningful periods (e.g. WHERE segments.date DURING LAST_30_DAYS); money fields are in micros (divide by 1,000,000, account currency). Prefer list_entities / get_report when they already answer the question — they normalise statuses (is_serving) and currencies. limit = rows returned to you (max 2000); total_rows tells you if more exist — narrow the query instead of paging through huge results. customer_id empty = the default connected account.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| query | Yes | ||
| customer_id | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||