account | GadsAccountItem or object or array of object or string or integer | Yes | - | Select the Google Ads account, ask user for it if not provided |
update_type | string or SelectableOption | Yes | - | Choose whether to update a single keyword or multiple keywords at once. Available options: ‘single’ (Single Update), ‘bulk’ (Bulk Updates) |
keyword_id | string or SelectableOption | No | - | Required for ‘single’ update mode. Accepts a bare numeric criterion ID (combine with ad_group_id, since the same criterion ID can exist in several ad groups), ‘<adGroupId><criterionId>’, or a full resource path ‘customers/<cust>/adGroupCriteria/<adGroupId><criterionId>’. |
ad_group_id | string or SelectableOption | No | - | Ad group ID for ‘single’ update mode. Recommended when keyword_id is a bare criterion ID; ignored if keyword_id already encodes the ad group. |
cpc_bid | number | No | - | Required for ‘single’ update mode. The keyword’s new max CPC bid in the account currency, e.g. 1.25 for $1.25. It overrides the ad group bid. |
structured_data | array (also accepts a comma-separated string) | No | - | Required when update type is ‘bulk’. Each row must contain ‘keyword_id’ and ‘cpc_bid’ (max CPC in account currency), and should contain ‘ad_group_id’ when keyword_id is a bare criterion ID. keyword_id accepts the same formats as in single mode. |
