Skip to main content
Executes custom Google Ads Query Language (GAQL) queries to retrieve any resource information from Google Ads API like campaign settings, budgets, bids, audiences, extensions, assets, keywords, ads, ad groups, search terms, conversion actions, bidding strategies, labels, locations, and shared sets. Prefer using the standard gads_get_report operation for normal performance reporting; use gads_run_gaql_query for advanced or unsupported reporting queries, resource lookups, or fields not covered by gads_get_report. If the exact FROM resource, metric, segment, or field compatibility is unclear, use gads_search_gaql_resources as an optional discovery helper. Note: Column names in the output replace dots with underscores for easier access. For example, campaign.id becomes campaign_id. Results are returned verbatim from the Google Ads API: Markifact applies no transformation or derivation, so any unexpected value comes from Google itself, not a Markifact bug. IMPORTANT: monetary fields are returned as raw values from Google in micros (1/1,000,000 of currency unit, e.g. 50000000 = $50). This includes any field whose name contains ‘micros’ (cost_micros, campaign_budget_amount_micros, average_cpc, average_cpm, etc.) — divide by 1,000,000 to get the actual dollar amount before passing to write operations like gads_update_campaign_budget.

​
Inputs

​
GadsAccountItem

​
Output

Type: List[Dict] Returns query results as rows, each row is a dict with keys matching selected fields. Note: Column names in the output replace dots with underscores for easier access. For example, campaign.id becomes campaign_id. Fields: dynamic (depend on the inputs)