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

您可以使用 Merchant API 管理本地（实体店内）和地区性商品目录。

请求

对广告资源使用以下请求网址格式 子 API：

POST https://merchantapi.googleapis.com/inventories/v1beta/{parent}/regionalInventories

在 Merchant API 中，Inventories 子 API 和相关端点都称为 表示为“inventory”

以下是 Content API for Shopping 与 Merchant Center 账号的对比情况 用于本地商品目录请求的 Inventories API：

	Content API	商家 API
网址	https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}/localinventory	https://merchantapi.googleapis.com/inventories/v1beta/{parent}/localInventories
标识符	{merchantId}/products/{productId}	{name}

方法

Merchant API 引入了两种新的产品目录管理方法：

• 列出商品的本地和地区商品目录
• 请从商品中移除本地商品目录和地区商品目录

下面对比了 Content API for Shopping 中的商品目录方法 Merchant Inventories API：

方法	Content API for Shopping	商家 API
customBatch	是	否
insert	是	是
list	否	是
delete	否	是

本地商品目录

以下是 Merchant Inventories API 中本地商品目录的变化：

Content API for Shopping	商家 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	商家 API	说明
不支持	name:string	添加了新字段，用于区分 product 中的 regionalInventory 资源。Content API for Shopping 用于根据 regionId 和 productId 识别地区性商品目录。
不支持	account:string	添加了新字段，用于标识 product 和 regionalInventory 所属的商家账号。
"regionId": string	"region": string	regionID 在 Merchant Inventories API 中称为 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。