透過店面商品目錄資料服務,您可以建立及更新店面商品目錄資源的執行個體,其中包含針對不同實體商店位置有不同值的欄位。每個店面庫存例項都是現有產品資源的子項,並沿用父項資源的產品資料欄位。舉例來說,假設某項產品在不同商店中的價格和數量不同,但在所有商店中都共用相同的 ID、說明和其他產品資料。店面商品目錄資料用於本地 Google 跨平台顯示和店面商品目錄廣告計畫。
本指南說明在開始使用店面商品目錄資料服務前的必要條件、可用欄位和方法,並提供服務要求範例。
先備知識
- 如要使用店面商品目錄資料服務,您必須建立商家檔案、將商家檔案連結至 Merchant Center 帳戶、驗證商家,以及設定商家檔案商店代碼。
您的 Merchant Center 帳戶必須註冊加入本地 Google 跨平台顯示計畫或店面商品目錄廣告。如要進一步瞭解如何透過 Content API 使用店面商品目錄廣告,請參閱「開始使用店面商品目錄廣告」一文。
店面商品目錄資料服務會為現有的店面產品建立店面商品目錄執行個體,您必須先使用 Content API 產品服務或 Merchant Center datafeeds 建立店面產品,並將
channel
欄位設為local
。接著,您就可以使用店面商品目錄資料服務,為銷售該產品的每個商家檔案storecode
建立店面商品目錄資料例項。
欄位
每個店面商品目錄資料執行個體都包含一組透過 storeCode
欄位 (在商家檔案中定義) 與特定門市位置相關聯的欄位。所有要求只需要 storecode
和 productId
。所有其他欄位皆為選填:
- 所有要求皆須具備:
storeCode
、productId
(在網址中) - 選用:
quantity
、price
、salePrice
、salePriceEffectiveDate
、availability
、pickupMethod
、pickupSla
、instoreProductLocation
如需店面商品目錄資料欄位的完整清單和相關說明,請參閱店面商品目錄資料參考資料頁面。
方法
店面商品目錄資料服務只包含兩種方法:
localinventory.insert
localinventory.insert
可讓您為單一店面產品建立店面商品目錄資料執行個體。
以下範例說明如何使用店面商品目錄資料服務建立店內銷售活動,從 2021 年 2 月 24 日下午 1 點到 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
可讓您為多個門市中的單一店面產品建立多個店面商品目錄資料執行個體,或是為多個店面產品建立店面商品目錄資料執行個體。