Writes (money-moving)

gads_propose_create_ad_group

Propose a new keyword silo: a new ad group under an existing Search campaign plus its keywords (approval-gated).

Propose a new keyword silo: a new ad group under an existing Search campaign plus its keywords (approval-gated). Use for expansion — group semantically-related search terms into one silo. Prefer BROAD match for exploration (Broad→Phrase→Exact). The ad group has no ad yet, so it won't serve until an RSA is added. Up to 50 keywords.

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
campaignIdstringYes
namestringYes
matchType"EXACT" | "PHRASE" | "BROAD"No(default: "BROAD")
cpcBidMicrosintegerNo
keywordsstring[]Yes
reasonstringYes
projectIdstringNoTarget account (project id) — required on account-scoped tools. Call gads_list_ad_accounts to enumerate accounts.

On this page