您可以使用 Merchant API 管理本地（实体店）和区域商品目录。
请求
请使用以下请求网址格式来调用“广告资源”子 API：
POST https://merchantapi.googleapis.com/inventories/v1beta/{PARENT}/regionalInventories
在 Merchant API 中，Inventories 子 API 和相关端点称为复数形式的“inventories”。
下面的示例比较了 Content API for Shopping 和 Merchant Inventories API 在本地商品目录请求方面的差异：
| Content API | Merchant API | |
|---|---|---|
| 网址 | https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID}/localinventory | https://merchantapi.googleapis.com/inventories/v1beta/{PARENT}/localInventories |
| 标识符 | {MERCHANT_ID}/products/{PRODUCT_ID} |
{NAME}
|
方法
Merchant API 引入了两种新的商品目录管理方法：
- 列出商品的本地和地区商品目录
- 从商品中移除本地和地区性商品目录
下面对比了 Content API for Shopping 和 Merchant Inventories API 中的商品目录方法：
| 方法 | Content API for Shopping | Merchant API |
|---|---|---|
customBatch |
是 | 否 |
insert |
是 | 是 |
list |
否 | 是 |
delete |
否 | 是 |
本地商品目录
Merchant Inventories API 中本地商品目录的相关变更如下：
| Content API for Shopping | Merchant API | 说明 |
|---|---|---|
| 不支持 | name:string
|
添加了新字段，以区分 product 中的 LocalInventory 资源。Content API for Shopping 会通过 storeCode 和 productId 来识别本地商品目录。
|
| 不支持 | account:string
|
添加了新字段，用于识别 product 和 LocalInventory 所属的商家账号。
|
price: {
|
price: {
|
Price 定义已更改。
|
salePrice: {
|
salePrice: {
|
Price 定义已更改。
|
salePriceEffectiveDate: string
|
salePriceEffectiveDate: {
|
salePriceEffectiveDate 在 Merchant Inventories API 中使用新的 TimePeriod 类型。
|
quantity:string,
|
quantity:integer
|
在 Merchant Inventories API 中，quantity 接受整数而非字符串。
|
kind:string
|
不支持 | Merchant Inventories API 不支持 kind。
|
| 不支持 | localShippingLabel:string
|
在 Merchant Inventories API 中添加了用于标记本地配送服务的新字段。 |
地区商品目录
以下是 Merchant Inventories API 中地区性商品目录的变更：
| Content API for Shopping | Merchant API | 说明 |
|---|---|---|
| 不支持 | name:string
|
添加了新字段，以区分 product 中的 regionalInventory 资源。Content API for Shopping 会通过 regionId 和 productId 来识别地区性商品目录。
|
| 不支持 | account:string
|
添加了新字段，用于识别 product 和 regionalInventory 所属的商家账号。
|
"regionId": string
|
"region": string
|
在 Merchant Inventories API 中，regionID 称为 region。
|
price: {
|
price: {
|
Price 定义已更改。
|
salePrice: {
|
salePrice: {
|
Price 定义已更改。
|
salePriceEffectiveDate: string
|
salePriceEffectiveDate: {
|
salePriceEffectiveDate 在 Merchant Inventories API 中使用新的 TimePeriod 类型。
|
kind:string
|
不支持 | Merchant Inventories API 不支持 kind。
|