您可以使用 Merchant API 管理本地(实体店)和区域商品目录。
请求
请使用以下请求网址格式来调用 Merchant Inventories API:
POST https://merchantapi.googleapis.com/inventories/v1/{PARENT}/regionalInventories
POST https://merchantapi.googleapis.com/inventories/v1/{PARENT}/localInventories
{PARENT} 的格式为:accounts/{ACCOUNT_ID}/products/ {PRODUCT_ID}。
以下是本地商品目录请求的比较示例:
| 项 | Content API for Shopping | Merchant API | 
|---|---|---|
| 网址 | https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID}/localinventory | https://merchantapi.googleapis.com/inventories/v1/{PARENT}/localInventories | 
| 标识符 | {MERCHANT_ID}/products/{PRODUCT_ID} | {NAME} | 
方法
Merchant API 引入了两种新的库存管理方法:
- list:用于列出商品的本地和区域商品目录。
- delete:用于删除商品的本地和区域商品目录。
以下是可用于管理广告资源的方法的比较:
| 方法 | Content API for Shopping | Merchant API | 
|---|---|---|
| customBatch | 是 | 否 | 
| insert | 是 | 是 | 
| list | 否 | 是 | 
| delete | 否 | 是 | 
资源
本地和区域商品目录的变化如下:
| Content API for Shopping | Merchant API | 说明 | 
|---|---|---|
| 不支持 | name:string | 该字段用于区分 product中的LocalInventory和RegionalInventory资源。Content API for Shopping 通过storeCode和productId识别本地商品目录,并通过regionId和productId识别区域性商品目录。 | 
| 不支持 | account:string | 添加了新字段,用于标识 product和LocalInventory所属的 Merchant Center 账号。 | 
| 
       price: {
           object (Price)
       }
    | price: {
 | Price定义已更改。 | 
| salePrice: {
 | salePrice: {
 | Price定义已更改。 | 
| salePriceEffectiveDate: string | salePriceEffectiveDate: {
 
 | salePriceEffectiveDate使用 Merchant Inventories API 中的新TimePeriod对象。 | 
| kind:string | 不支持 | 该 API 不支持 kind。 | 
| quantity:string | quantity:integer | quantity在本地商品目录中接受整数而不是字符串。 | 
| 不支持 | localShippingLabel:string | 添加了新字段,用于标识 product和regionalInventory所属的 Merchant Center 账号。 | 
| "regionId": string | "region": string | regionID现在称为region,用于区域性广告资源。 | 
| 具有已定义值集的 string类型字段 | 具有已定义值集的 enum类型字段 | 具有已定义值集的目录属性(例如 availability、pickupMethod)中的字段现在为enum类型。 |