Reads

gads_list_audiences

The account's audience surface: library (remarketing user lists incl.

The account's audience surface: library (remarketing user lists incl. customer-match uploaded in the Google Ads UI, custom segments) + current attachments on campaigns/ad groups (with observation/targeting mode and 30d performance). Attach audiences in OBSERVATION mode early — signal only accrues once attached. Customer-match list uploads themselves happen in the Google Ads UI (PII), then appear here after a sync.

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

Parameters

ParameterTypeRequiredDescription
campaignIdstringNo
daysintegerNo(default: 30)
projectIdstringNoTarget 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.

On this page