Writes (money-moving)
gads_propose_replace_ad
Replace a weak RSA in ONE approval: pause the old ad and create the new one atomically.
Replace a weak RSA in ONE approval: pause the old ad and create the new one atomically. Use when the ad group is at Google's 3-enabled-RSA cap (a plain proposeCreateRsa would fail) or when swapping a loser for stronger copy. Review-tier — queues for operator approval. 3–15 headlines (≤30 chars), 2–4 descriptions (≤90 chars).
Scope: write token required · money-moving. 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 |
|---|---|---|---|
adGroupId | string | Yes | |
pauseAdId | string | Yes | The existing ad to pause in the same mutate. |
headlines | string[] | Yes | |
descriptions | string[] | Yes | |
finalUrls | string[] | Yes | |
path1 | string | No | |
path2 | string | No | |
activateOnApprove | boolean | No | New ad goes live (ENABLED) on approval; false stages it paused. (default: true) |
reason | 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. |