update_keyword_bid
Update a keyword’s maximum CPC bid for manual-bidding ad groups. Safely rejects Smart Bidding and unrecognized strategies to prevent unintended changes.
Instructions
Draft a keyword CPC bid change (MS_ADS_MAX_CPC cap enforced). Allowed ONLY when the ad group's effective bid strategy is in the MANUAL_BIDDING allowlist (rails.py). Pre-rejected for Smart Bidding: UpdateKeywords silently ignores Bid there instead of erroring (live-verified — empty PartialErrors, bid unchanged on read-back), so this must be caught before the call, not after. Also rejected, fail closed, for any other unrecognized strategy or when the effective strategy can't be determined at all.
NOT live-verified for a landed bid change — the manual-bidding write path has never run live (no manual-bidding ad group exists on the development account).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"ad_group_id": "<ad_group_id>",
"keyword_id": "<keyword_id>",
"bid": "<bid>"
},
"name": "update_keyword_bid"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bid | Yes | ||
| keyword_id | Yes | ||
| ad_group_id | Yes |