你可以使用 Merchant API 管理店面 (店內) 和區域商品目錄。
要求
請使用以下的創意發想網址格式 sub-API:
POST https://merchantapi.googleapis.com/inventories/v1beta/{parent}/regionalInventories
在 Merchant API 中,第三方 API 和相關端點 視為複數形式的「廣告空間」
以下是 Content API for Shopping 與商家的差異範例 適用於店面商品目錄資料的 Intories API:
內容 API | 商家 API | |
---|---|---|
網址 | https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}/localinventory | https://merchantapi.googleapis.com/inventories/v1beta/{parent}/localInventories |
ID | {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: {
|
price: {
|
「Price 」定義已變更。
|
salePrice: {
|
salePrice: {
|
「Price 」定義已變更。
|
salePriceEffectiveDate: string
|
salePriceEffectiveDate: {
|
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: {
|
price: {
|
「Price 」定義已變更。
|
salePrice: {
|
salePrice: {
|
「Price 」定義已變更。
|
salePriceEffectiveDate: string
|
salePriceEffectiveDate: {
|
salePriceEffectiveDate 在 Merchant Inventories API 中使用新的 TimePeriod 類型。
|
kind:string
|
不支援 | Merchant Inventories API 不支援 kind 。
|