從 Content API for Shopping 遷移商品目錄管理功能

你可以使用 Merchant API 管理店面 (店內) 和區域商品目錄。

要求

請使用以下要求網址格式，針對Inventory 子 API：

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

在 Merchant API 中，「inventories」子 API 和相關端點會以複數形式表示。

以下是 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
ID	{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	quantity 會在 Merchant Inventories API 中使用整數，而非字串。
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	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。