您可以使用 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 类型。
|