maton google-ads query-stream

maton google-ads query-stream [flags]

POSTs a GAQL query to googleAds:searchStream and flattens the returned chunks into a single {results,…} envelope. Use this for very large result sets that would require many pages of “query”.

searchStream does not return nextPageToken; –paginate is a no-op here.

Options

--connection <string>
Connection ID to route through (Maton-Connection header)
-c, --customer-id <string>
Google Ads customer ID (required)
--dry-run
Print the request that would be sent without executing it
--fields <string>
Comma-separated fields to select
--format <string>
Output format: 'json' (default) or 'text' on supported commands
--gaql <string>
Raw GAQL query string
-q, --jq <expression>
Filter JSON output using a jq expression
-L, --limit <int> (default 0)
LIMIT number of results (0 = no limit)
--order-by <string>
ORDER BY field
--paginate
Follow next_cursor and concatenate all pages (list commands only)
--resource <string>
GAQL resource (e.g. campaign, ad_group, keyword_view)
--template <string>
Format JSON output using a Go template; see "maton help formatting"
--where <string>
WHERE clause (e.g. "campaign.status != 'REMOVED'")

Options inherited from parent commands

--login-customer-id <string>
Manager account ID for MCC access (forwarded as login-customer-id header)
-p, --profile <string>
Profile to use for this invocation (overrides the active profile; also reads MATON_PROFILE)

Examples

$ maton google-ads query-stream -c 1234567890 --gaql 'SELECT campaign.id FROM campaign'

See also