Reads

gads_search_audience_ideas

Search Google's in-market/affinity interest taxonomy LIVE by name (e.g.

Search Google's in-market/affinity interest taxonomy LIVE by name (e.g. 'dating', 'photography services') — returns user_interest ids you can attach via proposeAttachAudience (audienceKind user_interest, observation mode first). The taxonomy is thousands of static entries, so it's looked up live rather than warehoused.

Scope: read token (or higher). Read-only.

Parameters

Parameter	Type	Required	Description
`query`	`string`	Yes
`projectId`	`string`	No	Target account (project id). Required with an org-scoped token for account-scoped tools — call gads_list_ad_accounts to enumerate accounts. Omit with a project-scoped token.

gads_run_gaql_query

Run a read-only GAQL query against the LIVE Google Ads API for data not warehoused (e.g.

gads_discover_ad_accounts

List every Google Ads account the workspace's connection can reach (listAccessibleCustomers + MCC children), flagging which are already imported.

gads_search_audience_ideas

Parameters

On this page