Writes (money-moving)
gads_propose_add_keywords
Propose adding keywords to an ad group (up to 50).
Propose adding keywords to an ad group (up to 50). 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). ≤10 exact-match keywords with bounded bids apply automatically.
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 | |
keywords | object[] | Yes | |
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. |