Writes (money-moving)
gads_propose_change_keyword_match_type
Change a keyword's match type in ONE approval.
Change a keyword's match type in ONE approval. Match type is immutable in the API, so this creates the sibling keyword at the new match type and pauses the old one atomically (e.g. tighten a wasteful BROAD keyword to EXACT). Review-tier — queues for operator approval.
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 | |
criterionId | string | Yes | The existing keyword to change. |
newMatchType | "EXACT" | "PHRASE" | "BROAD" | Yes | |
cpcBidMicros | integer | No | Optional bid for the new keyword; omit to inherit the ad-group default. |
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. |