店面庫存服務

你可以透過店面商品目錄服務建立及更新店面商品目錄資源的例項，其中包含的欄位可針對不同實體商店位置設定不同值。每個店面商品目錄執行個體都是現有產品資源的子項，並會從父項資源繼承產品資料欄位。舉例來說，某項產品在不同商店的價格和數量可能不同，但所有商店的 ID、說明和其他產品資料都相同。店面商品目錄資料會用於「本地 Google 跨平台顯示」和「店面商品目錄廣告」計畫。

本指南說明開始使用店面商品目錄服務前需要完成的準備工作，並介紹可用的欄位和方法，以及提供服務要求的範例。

必要條件

• 如要使用店面商品目錄服務，你必須建立商家檔案、將商家檔案連結至 Merchant Center 帳戶、驗證商家，以及設定商家檔案商店代碼。

• Merchant Center 帳戶必須註冊店面計畫：Google 跨平台顯示店面資訊或店面商品目錄廣告。如要進一步瞭解如何透過 Content API 使用店面商品目錄廣告，請參閱「開始使用店面商品目錄廣告」。

• 店面商品目錄服務會為現有的店面產品建立店面商品目錄例項。你必須先使用 Content API products 服務或 Merchant Center datafeeds，將 channel 欄位設為 local，建立店面產品。接著，你可以使用店面商品目錄服務，為銷售產品的每個商家檔案 storecode 建立店面商品目錄執行個體。

欄位

每個店面商品目錄執行個體都包含一組欄位，這些欄位透過 storeCode 欄位與特定商店位置相關聯 (您在商家檔案中定義這些欄位)。所有要求都只需要 storecode 和 productId。其他欄位均為選填：

• 所有要求都必須提供：storeCode、productId (位於網址中)
• 選用：quantity、price、salePrice、salePriceEffectiveDate、availability、pickupMethod、pickupSla、instoreProductLocation

如需店面商品目錄欄位及其說明的完整清單，請參閱localinventory參考頁面。

方法

店面商品目錄服務只包含兩種方法：

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 可為多間商店中的單一店面產品建立多個店面商品目錄例項，或為多個店面產品建立店面商品目錄例項。