店面商品目錄服務可讓您建立及更新店面商品目錄資源的執行個體,其中所含的欄位可以為不同的實體商店位置提供不同的值。每個店面商品目錄執行個體都是現有產品資源的子項,會沿用父項資源的產品資料欄位。舉例來說,某個產品的價格和數量在不同門市都不一樣,但所有商店都共用相同的 ID、說明和其他產品資料。店面商品目錄資料會用於本地 Google 跨平台顯示和店面商品目錄廣告計畫。
本指南將說明開始使用店面商品目錄服務前的必要條件、說明可用的欄位和方法,並提供服務要求範例。
必要條件
- 如要使用店面商品目錄服務,您必須建立商家檔案、將商家檔案連結至 Merchant Center 帳戶、驗證商家,以及設定商家檔案商店代碼。
Merchant Center 帳戶必須註冊本地計畫:本地 Google 跨平台顯示或店面商品目錄廣告。如要進一步瞭解如何透過 Content API 使用店面商品目錄廣告,請參閱「開始使用店面商品目錄廣告」一文。
店面商品目錄服務為現有的店面產品建立店面商品目錄執行個體。您必須先使用 Content API 產品服務或 Merchant Center 資料動態饋給,將
channel
欄位設為local
,才能建立店面產品。接著,您可以使用店面商品目錄服務,為每個銷售產品的商家檔案storecode
建立店面商品目錄執行個體。
欄位
每個店面商品目錄執行個體都包含一組欄位,這些欄位透過 storeCode
欄位 (您在商家檔案中定義的欄位) 與特定門市地點相關聯。所有要求只需要 storecode
和 productId
。所有其他欄位均為選填:
- 所有要求都必須提供:
storeCode
、productId
(在網址中) - 選用:
quantity
、price
、salePrice
、salePriceEffectiveDate
、availability
、pickupMethod
、pickupSla
、instoreProductLocation
如需店面庫存欄位及其說明的完整清單,請參閱店面商品目錄資料參考資料頁面。
方法
店面商品目錄資料服務僅提供兩種方法:
localinventory.insert
localinventory.insert
可讓您為單一店面產品建立店面商品目錄執行個體。
這個範例說明瞭如何使用店面商品目錄服務建立店內銷售活動 (自 2021 年 2 月 24 日晚上 1 點 (GMT-8) 到 2021 年 2 月 28 日下午 3 點 30 分 (GMT-8) 為止。這項要求也會更新店面商品目錄執行個體的可用數量。與非店面產品資料的補充動態饋給不同,未包含在要求主體中的欄位會由這個呼叫覆寫:
POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId/localinventory
{
"storeCode": “1235”,
"salePrice": {
"value": “100.00”,
"currency": “USD”
},
"salePriceEffectiveDate": “2021-02-24T13:00-0800/2021-02-28T15:30-0800”,
"quantity": 200,
}
localinventory.custombatch
localinventory.custombatch
可讓您為多間商店中的單一店面產品建立多個店面商品目錄執行個體,或是為多個店面產品建立店面商品目錄執行個體。