从 Content API for Shopping 迁移产品目录管理系统

您可以使用 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: { object (Price) }	price: { object (Price) }	Price 定义已更改。
salePrice: { object (Price) }	salePrice: { object (Price) }	Price 定义已更改。
salePriceEffectiveDate: string	salePriceEffectiveDate: { object (TimePeriod) },	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: { object (Price) }	price: { object (Price) }	Price 定义已更改。
salePrice: { object (Price) }	salePrice: { object (Price) }	Price 定义已更改。
salePriceEffectiveDate: string	salePriceEffectiveDate: { object (TimePeriod) },	salePriceEffectiveDate 在 Merchant Inventories API 中使用新的 TimePeriod 类型。
kind:string	不支持	Merchant Inventories API 不支持 kind。