Writes (money-moving)

gads_propose_keyword_status

Propose enabling, pausing, or removing a keyword.

Propose enabling, pausing, or removing a keyword. Safe, bounded changes apply automatically under the org's policy; everything else queues for operator approval. The result states which happened (mode) and why (policyReasons). Pauses apply automatically; enable/remove queue.

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

ParameterTypeRequiredDescription
adGroupIdstringYes
criterionIdstringYes
status"ENABLED" | "PAUSED" | "REMOVED"Yes
reasonstringYes
projectIdstringNoTarget account (project id) — required on account-scoped tools. Call gads_list_ad_accounts to enumerate accounts.

On this page