read

Run an arbitrary read-only Google Ads Query Language (GAQL) query against the store's Google Ads account and get rows ba

Run an arbitrary read-only Google Ads Query Language (GAQL) query against the store's Google Ads account and get rows back. Covers the whole reporting surface: campaigns, ad_group, keyword_view, search_term_view, ad_group_ad, asset, geographic_view, campaign_criterion, change_event, etc. Example: "SELECT campaign.name, metrics.clicks, metrics.cost_micros FROM campaign WHERE segments.date DURING LAST_7_DAYS ORDER BY metrics.clicks DESC". Queries the Google Ads API, see https://developers.google.com/google-ads/api/docs/query/overview

post/api/v1/tools/ads_run_gaql

Request

  • Base URL: https://app.magistry.io
  • URL: https://app.magistry.io/api/v1/tools/ads_run_gaql
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.magistry.io/api/oauth/authorize, token URL https://app.magistry.io/api/oauth/token, scopes: ads:read)

Request body

querystring required

A GAQL SELECT query.

limitinteger

Max rows returned (default 500).

Response

Tool result

okboolean required
resultunknown required

Changes

No recorded changes to this operation across all 2 revisions of this API.