REST Resource: accounts.products.regionalInventories
Stay organized with collections
Save and categorize content based on your preferences.
Resource: RegionalInventory
| JSON representation |
{
"name": string,
"account": string,
"region": string,
"regionalInventoryAttributes": {
object (RegionalInventoryAttributes)
}
} |
| Fields |
name |
string
Output only. The name of the RegionalInventory resource. Format: {regionalInventory.name=accounts/{account}/products/{product}/regionalInventories/{region}
|
account |
string (int64 format)
Output only. The account that owns the product. This field will be ignored if set by the client.
|
region |
string
Required. Immutable. ID of the region for this RegionalInventory resource. See the Regional availability and pricing for more details.
|
regionalInventoryAttributes |
object (RegionalInventoryAttributes)
Optional. A list of regional inventory attributes.
|
RegionalInventoryAttributes
Regional inventory attributes.
| JSON representation |
{
"price": {
object (Price)
},
"salePrice": {
object (Price)
},
"salePriceEffectiveDate": {
object (Interval)
},
"availability": enum (Availability)
} |
| Fields |
price |
object (Price)
Optional. Price of the product in this region.
|
salePrice |
object (Price)
Optional. Sale price of the product in this region. Mandatory if [salePriceEffectiveDate][RegionalInventory.sale_price_effective_date] is defined.
|
salePriceEffectiveDate |
object (Interval)
Optional. The TimePeriod of the sale price in this region.
|
availability |
enum (Availability)
Optional. Availability of the product in this region.
|
Availability
| Enums |
REGIONAL_INVENTORY_AVAILABILITY_UNSPECIFIED |
Indicates that the availability is unspecified. |
IN_STOCK |
Indicates that the product is in stock. |
OUT_OF_STOCK |
Indicates that the product is out of stock. |
Methods |
|
|
Deletes the specified RegionalInventory resource from the given product in your merchant account. |
|
|
Inserts a RegionalInventory to a given product in your merchant account. |
|
|
Lists the RegionalInventory resources for the given product in your merchant account. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-07-31 UTC.
[null,null,["Last updated 2025-07-31 UTC."],[],[],null,["# REST Resource: accounts.products.regionalInventories\n\n- [Resource: RegionalInventory](#RegionalInventory)\n - [JSON representation](#RegionalInventory.SCHEMA_REPRESENTATION)\n- [RegionalInventoryAttributes](#RegionalInventoryAttributes)\n - [JSON representation](#RegionalInventoryAttributes.SCHEMA_REPRESENTATION)\n- [Availability](#Availability)\n- [Methods](#METHODS_SUMMARY)\n\nResource: RegionalInventory\n---------------------------\n\nRegional inventory information for the product. Represents specific information like price and availability for a given product in a specific [`region`](/merchant/api/reference/rest/inventories_v1/accounts.products.regionalInventories#RegionalInventory.FIELDS.region). For a list of all accepted attribute values, see the [regional product inventory data specification](https://support.google.com/merchants/answer/9698880).\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"account\": string, \"region\": string, \"regionalInventoryAttributes\": { object (/merchant/api/reference/rest/inventories_v1/accounts.products.regionalInventories#RegionalInventoryAttributes) } } ``` |\n\n| Fields ||\n|-------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Output only. The name of the `RegionalInventory` resource. Format: `{regionalInventory.name=accounts/{account}/products/{product}/regionalInventories/{region}` |\n| `account` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. The account that owns the product. This field will be ignored if set by the client. |\n| `region` | `string` Required. Immutable. ID of the region for this `RegionalInventory` resource. See the [Regional availability and pricing](https://support.google.com/merchants/answer/9698880) for more details. |\n| `regionalInventoryAttributes` | `object (`[RegionalInventoryAttributes](/merchant/api/reference/rest/inventories_v1/accounts.products.regionalInventories#RegionalInventoryAttributes)`)` Optional. A list of regional inventory attributes. |\n\nRegionalInventoryAttributes\n---------------------------\n\nRegional inventory attributes.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"price\": { object (/merchant/api/reference/rest/Shared.Types/Price) }, \"salePrice\": { object (/merchant/api/reference/rest/Shared.Types/Price) }, \"salePriceEffectiveDate\": { object (/merchant/api/reference/rest/Shared.Types/Interval) }, \"availability\": enum (/merchant/api/reference/rest/inventories_v1/accounts.products.regionalInventories#Availability) } ``` |\n\n| Fields ||\n|--------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `price` | `object (`[Price](/merchant/api/reference/rest/Shared.Types/Price)`)` Optional. Price of the product in this region. |\n| `salePrice` | `object (`[Price](/merchant/api/reference/rest/Shared.Types/Price)`)` Optional. Sale price of the product in this region. Mandatory if \\[`salePriceEffectiveDate`\\]\\[RegionalInventory.sale_price_effective_date\\] is defined. |\n| `salePriceEffectiveDate` | `object (`[Interval](/merchant/api/reference/rest/Shared.Types/Interval)`)` Optional. The `TimePeriod` of the sale price in this region. |\n| `availability` | `enum (`[Availability](/merchant/api/reference/rest/inventories_v1/accounts.products.regionalInventories#Availability)`)` Optional. [Availability](https://support.google.com/merchants/answer/14644124) of the product in this region. |\n\nAvailability\n------------\n\n[Availability](https://support.google.com/merchants/answer/14644124) of the product in this region.\n\n| Enums ||\n|-----------------------------------------------|-------------------------------------------------|\n| `REGIONAL_INVENTORY_AVAILABILITY_UNSPECIFIED` | Indicates that the availability is unspecified. |\n| `IN_STOCK` | Indicates that the product is in stock. |\n| `OUT_OF_STOCK` | Indicates that the product is out of stock. |\n\n| Methods ------- ||\n|--------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------|\n| ### [delete](/merchant/api/reference/rest/inventories_v1/accounts.products.regionalInventories/delete) | Deletes the specified `RegionalInventory` resource from the given product in your merchant account. |\n| ### [insert](/merchant/api/reference/rest/inventories_v1/accounts.products.regionalInventories/insert) | Inserts a `RegionalInventory` to a given product in your merchant account. |\n| ### [list](/merchant/api/reference/rest/inventories_v1/accounts.products.regionalInventories/list) | Lists the `RegionalInventory` resources for the given product in your merchant account. |"]]
