REST Resource: accounts.products.regionalInventories
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
资源:RegionalInventory
JSON 表示法 |
{
"name": string,
"account": string,
"region": string,
"price": {
object (Price )
},
"salePrice": {
object (Price )
},
"salePriceEffectiveDate": {
object (Interval )
},
"customAttributes": [
{
object (CustomAttribute )
}
],
"availability": string
} |
字段 |
name |
string
仅限输出。RegionalInventory 资源的名称。格式:{regionalInventory.name=accounts/{account}/products/{product}/regionalInventories/{region}
|
account |
string (int64 format)
仅限输出。产品所属的账号。如果由客户端设置,系统会忽略此字段。
|
region |
string
必需。不可变。此 RegionalInventory 资源的区域 ID。如需了解详情,请参阅地区性库存状况和价格。
|
price |
object (Price )
商品在此地区的价格。
|
salePrice |
object (Price )
商品在此地区的促销价。如果定义了 salePriceEffectiveDate ,则必须提供。
|
salePriceEffectiveDate |
object (Interval )
此地区促销价的 TimePeriod 。
|
customAttributes[] |
object (CustomAttribute )
自定义(商家提供)属性的列表。您还可以使用 CustomAttribute 以通用形式提交数据规范的任何属性。
|
availability |
string
商品在此地区的供应情况。如需了解可接受的属性值,请参阅地区商品目录数据规范
|
方法 |
|
从商家账号中的指定商品中删除指定的 RegionalInventory 资源。 |
|
在您的商家账号中为指定商品插入 RegionalInventory 。 |
|
列出商家账号中指定商品的 RegionalInventory 资源。 |
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-11-21。
[null,null,["最后更新时间 (UTC):2024-11-21。"],[[["\u003cp\u003e\u003ccode\u003eRegionalInventory\u003c/code\u003e resources store product-specific details like price and availability for different regions.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage regional inventory data using methods like \u003ccode\u003einsert\u003c/code\u003e, \u003ccode\u003edelete\u003c/code\u003e, and \u003ccode\u003elist\u003c/code\u003e to create, remove, or retrieve regional inventory information.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eRegionalInventory\u003c/code\u003e resource includes fields such as \u003ccode\u003eprice\u003c/code\u003e, \u003ccode\u003esalePrice\u003c/code\u003e, \u003ccode\u003eavailability\u003c/code\u003e, and \u003ccode\u003ecustomAttributes\u003c/code\u003e allowing for detailed product configuration per region.\u003c/p\u003e\n"],["\u003cp\u003eRefer to the regional product inventory data specification for accepted values for attributes like \u003ccode\u003eavailability\u003c/code\u003e and to understand the structure of regional inventory data.\u003c/p\u003e\n"]]],["RegionalInventory provides product-specific price and availability in a given region. Key information includes the region ID, product price, sale price, sale price effective date, custom attributes, and availability. The data is represented in JSON format, detailing these fields. Available actions include deleting, inserting, and listing RegionalInventory resources for a product within a merchant account, enabling management of regional product information.\n"],null,["# REST Resource: accounts.products.regionalInventories\n\n- [Resource: RegionalInventory](#RegionalInventory)\n - [JSON representation](#RegionalInventory.SCHEMA_REPRESENTATION)\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_v1beta/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, \"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) }, \"customAttributes\": [ { object (/merchant/api/reference/rest/Shared.Types/CustomAttribute) } ], \"availability\": string } ``` |\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| `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`](/merchant/api/reference/rest/inventories_v1beta/accounts.products.regionalInventories#RegionalInventory.FIELDS.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| `customAttributes[]` **(deprecated)** | `object (`[CustomAttribute](/merchant/api/reference/rest/Shared.Types/CustomAttribute)`)` | This item is deprecated! A list of custom (merchant-provided) attributes. You can also use `CustomAttribute` to submit any attribute of the data specification in its generic form. |\n| `availability` | `string` Availability of the product in this region. For accepted attribute values, see the [regional product inventory data specification](https://support.google.com/merchants/answer/14644124). |\n\n| Methods ------- ||\n|------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------|\n| ### [delete](/merchant/api/reference/rest/inventories_v1beta/accounts.products.regionalInventories/delete) | Deletes the specified `RegionalInventory` resource from the given product in your merchant account. |\n| ### [insert](/merchant/api/reference/rest/inventories_v1beta/accounts.products.regionalInventories/insert) | Inserts a `RegionalInventory` to a given product in your merchant account. |\n| ### [list](/merchant/api/reference/rest/inventories_v1beta/accounts.products.regionalInventories/list) | Lists the `RegionalInventory` resources for the given product in your merchant account. |"]]