API


驗證

如要透過特定 Merchant Center 帳戶使用 Merchant API for Shopping, 必須設定 API 控制台專案。Google Cloud 控制台專案說明 管理 Merchant API 解決方案的 API 存取權和驗證作業。

視用途而定,您可以透過兩種方式存取 Merchant API:

  • 建議使用 OAuth 2.0 來存取特定 Merchant Center 透過您為使用者開發的應用程式存取帳戶使用者將 必須授予帳戶存取權,才能代為提交資料。
  • 「服務帳戶」是一種特殊帳戶,通常由服務帳戶使用 而非使用者服務帳戶可透過電子郵件地址來辨識 專屬位址,專屬於帳戶。

請參閱使用 OAuth 2.0 或服務進行驗證的方式 帳戶

啟用國家/地區設定

呼叫 liasettings.update 以指定您所在的國家/地區 提供區域服務

進一步瞭解國家/地區設定目標頁面

傳送優惠資料

資料分為兩種:產品和商品目錄資料。

offer_inventory_expiration

一次傳送產品和商品目錄資料

您可以利用以下方式一次提交產品和商品目錄資料: accounts.lfpInventories.insert

「GTIN」欄位實際上可做為 Google 目錄的產品 ID 並自動建立產品動態饋給

這個自動建立的動態饋給在目標 Merchant Center 中會顯示為 「本地動態饋給供應商」並附上相關優惠的資訊

如果所有商家的產品都具備全球交易品項識別碼,且沒有其他實體,這個方法就非常實用 即將啟用的功能 (例如「商家代管的本地店面基本版」)。 如果您打算為商家啟用 MHLSF,請傳送專屬的產品動態饋給 是建議設定

相同程序也可以使用 accounts.lfpSales.insert

這裡的資料是指某網站上特定產品的「銷售」事件 系統就會排除這段文字

分別傳送產品和商品目錄資料

如果全球交易品項識別碼不普及 目標 Merchant Center 帳戶中現有的產品動態饋給 為商家啟用 MHLSF,你必須使用特定的店面產品動態饋給。

呼叫 accounts.productInputs.insert 即可啟用這項功能 首先,插入產品的所有靜態價值記得使用 將 Channel 屬性設為「local」。

如要進一步瞭解基本產品資料,請參閱這篇文章API 產品插入的一般指南

資料流程如下:

或者,商品目錄資料 accounts.lfpSales.insert.機器學習模型就會 根據這項資料預測商品的價格和數量。

accounts.lfpInventories.insert, accounts.lfpSales.insert 的總覽範例 accounts.lfpStores.insert

傳送商家檔案資料

無法存取商家的 Google 商家檔案帳戶時 擷取商家代碼,則可透過 accounts.lfpStores.insert,改成您實際使用的商店代碼。

請注意,呼叫 accounts.lfpinventoryories.insert 或 accounts.lfpSales.insert 商店代碼必須與商店代碼相符 。

accounts.lfpStores.insert 的回應也會提供 matchingStatematchingStateHint