- [Resource: RegionalInventory](https://developers.google.com/merchant/api/reference/rest/inventories_v1/accounts.products.regionalInventories.md.txt#RegionalInventory)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/inventories_v1/accounts.products.regionalInventories.md.txt#RegionalInventory.SCHEMA_REPRESENTATION)
- [RegionalInventoryAttributes](https://developers.google.com/merchant/api/reference/rest/inventories_v1/accounts.products.regionalInventories.md.txt#RegionalInventoryAttributes)
  - [JSON representation](https://developers.google.com/merchant/api/reference/rest/inventories_v1/accounts.products.regionalInventories.md.txt#RegionalInventoryAttributes.SCHEMA_REPRESENTATION)
- [Availability](https://developers.google.com/merchant/api/reference/rest/inventories_v1/accounts.products.regionalInventories.md.txt#Availability)
- [Methods](https://developers.google.com/merchant/api/reference/rest/inventories_v1/accounts.products.regionalInventories.md.txt#METHODS_SUMMARY)

## Resource: RegionalInventory

Regional inventory information for the product. Represents specific information like price and availability for a given product in a specific `` `region` ``. For a list of all accepted attribute values, see the [regional product inventory data specification](https://support.google.com/merchants/answer/9698880).

For more information, see [Add regional inventory](https://developers.google.com/merchant/api/guides/inventories/add-regional-inventory.md.txt), [Update regional inventory](https://developers.google.com/merchant/api/guides/inventories/update-regional-inventory.md.txt), and [Create and update regions](https://developers.google.com/merchant/api/guides/accounts/regions.md.txt).

| JSON representation |
|---|
| ``` { "name": string, "base64EncodedName": string, "account": string, "region": string, "regionalInventoryAttributes": { object (`RegionalInventoryAttributes`) } } ``` |

| Fields ||
|---|---|
| `name` | `string` Output only. The name of the `RegionalInventory` resource. Format: `accounts/{account}/products/{product}/regionalInventories/{region}` The `{product}` segment is a unique identifier for the product. This identifier must be unique within a merchant account and generally follows the structure: `contentLanguage~feedLabel~offerId`. Example: `en~US~sku123` For legacy local products, the structure is: `local~contentLanguage~feedLabel~offerId`. Example: `local~en~US~sku123` The format of the `{product}` segment in the URL is automatically detected by the server, supporting two options: 1. **Encoded Format** : The `{product}` segment is an **unpadded base64url** encoded string (RFC 4648 Section 5). The decoded string must result in the `contentLanguage~feedLabel~offerId` structure. This encoding MUST be used if any part of the product identifier (like `offerId`) contains characters such as `/`, `%`, or `~`. - Example: To represent the product ID `en~US~sku/123` for `region` "region123", the `{product}` segment must be the unpadded base64url encoding of this string, which is `ZW5-VVN-c2t1LzEyMw`. The full resource name for the regional inventory would be `accounts/123/products/ZW5-VVN-c2t1LzEyMw/regionalInventories/region123`. 2. **Plain Format** : The `{product}` segment is the tilde-separated string `contentLanguage~feedLabel~offerId`. This format is suitable only when `contentLanguage`, `feedLabel`, and `offerId` do not contain URL-problematic characters like `/`, `%`, or `~`. We recommend using the **Encoded Format** for all product IDs to ensure correct parsing, especially those containing special characters. The presence of tilde (`~`) characters in the `{product}` segment is used to differentiate between the two formats. |
| `base64EncodedName` | `string` Output only. The unpadded base64url encoded name of the `RegionalInventory` resource. Format: `accounts/{account}/products/{product}/regionalInventories/{region}` where the `{product}` segment is the unpadded base64url encoded value of the identifier of the form `contentLanguage~feedLabel~offerId`. Example: `accounts/123/products/ZW5-VVN-c2t1LzEyMw/regionalInventories/region123` for the decoded product ID `en~US~sku/123` and `region` "region123". Can be used directly as input to the API methods that require the product identifier within the regional inventory name to be encoded if it contains special characters, for example [`GetRegionalInventory`](https://developers.google.com/merchant/api/reference/rest/inventories_v1/accounts.products.regionalInventories/get). |
| `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](https://support.google.com/merchants/answer/9698880) 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`) }, "loyaltyPrograms": [ { object (`InventoryLoyaltyProgram`) } ], "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. |
| `loyaltyPrograms[]` | ``object (`InventoryLoyaltyProgram`)`` Optional. An optional list of loyalty programs containing applicable loyalty member prices for this product in this region. This field is used to show region-specific member prices on Product Listing Ads (PLA). To use this, the loyalty program must be configured in Google Merchant Center, and the merchant must be using the Regional Availability and Pricing (RAAP) feature. The benefits provided must match the merchant's website and be clear to members. This is only applicable for merchants in supported countries. See [Loyalty program](https://support.google.com/merchants/answer/12922446) for details on supported countries and loyalty program configuration. Also see [Regional availability and pricing](https://support.google.com/merchants/answer/14644124) and [How to set up regional member pricing](https://support.google.com/merchants/answer/16388178) for more information. |
| `availability` | ``enum (`Availability`)`` Optional. [Availability](https://support.google.com/merchants/answer/14644124) of the product in this region. |

## Availability

[Availability](https://support.google.com/merchants/answer/14644124) of the product in this region.

| 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 ||
|---|---|
| ### `delete` | Deletes the specified `RegionalInventory` resource from the given product in your merchant account. |
| ### `insert` | Inserts a `RegionalInventory` to a given product in your merchant account. |
| ### `list` | Lists the `RegionalInventory` resources for the given product in your merchant account. |