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.
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 |
|---|---|---|---|
adGroupId | string | Yes | |
keywords | object[] | Yes | |
exploratory | boolean | No | Mark this as an exploratory probe from the plan's explore group — an unproven bet against the explore budget, not a harvested winner. Exploratory adds ALWAYS queue for review, never auto-apply, however small and bounded they are. |
reason | string | Yes | |
projectId | string | No | Target account (project id) — required on account-scoped tools. Call gads_list_ad_accounts to enumerate accounts. |