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.
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 | |
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). Optional when exactly one authorized stored account exists. Use gads_list_ad_accounts or gads_get_connection_status to select among multiple accounts. |