Operate on item level bid options
This endpoint supports multiple operations on a set of one or more bid options (bid price and bid adjustments for targeting categories) for retail catalog items. These advanced auction settings are applied in campaigns using objective_type CATALOG_SALES and ad groups using bid_strategy_type MAX_BID.
The catalog must be owned by the "operation user_account". See detailed documentation here. By default, the "operation user_account" is the token user_account.
Optional: Business Access: Specify an ad_account_id (obtained via List ad accounts) to use the owner of that ad_account as the "operation user_account". In order to do this, the token user_account must have one of the following Business Access roles on the ad_account: Owner, Admin.
This endpoint is not available to all users.
Query parameters
Unique identifier of an ad account.
Request body
Example request
{
"items": [
{
"item_id": "DS0294-M",
"country": "US",
"language": "EN",
"operation": "UPSERT",
"bid_options": {
"bid_in_micro_currency": 5000000,
"app_type_multipliers": {
"android_mobile": 1.1,
"android_tablet": 1.1,
"ipad": 1.2,
"iphone": 1.2,
"web": 0.9,
"web_mobile": 0.8
}
},
"update_mask": [
"BID",
"APP_TYPE_BID_MULTIPLIER_SET"
],
"errors": [
{
"code": 6,
"message": "Bid in micro currency should be non-negative"
}
]
}
]
}Response
The request has succeeded.
Example response
{
"items": [
{
"item_id": "DS0294-M",
"country": "US",
"language": "EN",
"operation": "UPSERT",
"bid_options": {
"bid_in_micro_currency": 5000000,
"app_type_multipliers": {
"android_mobile": 1.1,
"android_tablet": 1.1,
"ipad": 1.2,
"iphone": 1.2,
"web": 0.9,
"web_mobile": 0.8
}
},
"update_mask": [
"BID",
"APP_TYPE_BID_MULTIPLIER_SET"
],
"errors": [
{
"code": 6,
"message": "Bid in micro currency should be non-negative"
}
]
}
]
}