gads_propose_attach_audience
Attach an audience (remarketing user list, custom segment, or in-market/affinity interest) to a campaign or ad group.
Attach an audience (remarketing user list, custom segment, or in-market/affinity interest) to a campaign or ad group. mode 'observation' (default) is SAFE-tier — it changes NOTHING about serving, it only starts collecting audience signal (attach early; data only accrues once attached, and Smart Bidding uses it as a signal). mode 'targeting' restricts serving to the audience and exclude blocks it — both review-tier. Find audiences via gads_list_audiences / gads_search_audience_ideas.
Type: money-moving write. Every write is dry-run validated, then classified by the safe-apply policy — auto-applied when bounded and low-risk, otherwise queued for approval.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
level | "campaign" | "ad_group" | Yes | |
campaignId | string | No | |
adGroupId | string | No | |
audienceKind | "user_list" | "custom_audience" | "user_interest" | Yes | |
audienceId | string | Yes | |
mode | "observation" | "targeting" | No | (default: "observation") |
exclude | boolean | No | Campaign-level only: block serving to this audience. |
reason | string | Yes | |
projectId | string | No | Target account (project id). Optional when exactly one authorized stored account exists. Use gads_list_ad_accounts or gads_get_connection_status to select among multiple accounts. |
gads_propose_asset_link_status
Pause or re-enable an existing asset LINK (sitelink/callout/snippet/price/promotion/image on a campaign or the account) — e.g.
gads_propose_brand_exclusion
Propose attaching a brand exclusion list to a Search campaign (SharedSet BRANDS + negative CampaignCriterion.brand_list).