Sets regional price and availability overrides for products, one or many at once (up to 200)
Sets regional price and availability overrides for products, one or many at once (up to 200). The fastest way to update prices per region without touching the product itself. Prices are raw Google micros (amountMicros).
Select the Merchant Center account that owns the products.
update_type
string or SelectableOption
Yes
-
Choose whether to update one product’s inventory or many at once. Options: single or bulk.
product_id
string or SelectItem
No
-
Product identifier in the form contentLanguagefeedLabelofferId, for example enUSsku123. Required for single mode.
inventory
object or string
No
-
Official Google Merchant API RegionalInventory body as an object or JSON string, sent as-is. Keys: region (region ID from gmc_list_regions) and regionalInventoryAttributes with price/salePrice ({amountMicros, currencyCode}), salePriceEffectiveDate, and availability. Inserting for an existing region replaces the entry. Example: {“region”: “123456”, “regionalInventoryAttributes”: {“price”: {“amountMicros”: “33450000”, “currencyCode”: “USD”}, “availability”: “IN_STOCK”}}. Required for single mode.
structured_data
array (also accepts a comma-separated string)
No
-
Use only when update_type is bulk. A list of up to 200 rows, each with product_id and inventory (the official RegionalInventory body).
return_detailed_results
boolean
No
False
Bulk mode only. If true, returns per-row results and does not raise on partial failures.