你可以透過店面商品目錄服務建立及更新店面商品目錄資源的例項,其中包含的欄位可針對不同實體商店位置設定不同值。每個店面商品目錄執行個體都是現有產品資源的子項,並會從父項資源繼承產品資料欄位。舉例來說,某項產品在不同商店的價格和數量可能不同,但所有商店的 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
可為多間商店中的單一店面產品建立多個店面商品目錄例項,或為多個店面產品建立店面商品目錄例項。