Merchant Product API 總覽

本頁面將說明如何透過程式輔助上傳及管理產品。 使用 Merchant Products API 時,您可以在資料來源中插入或更新產品、從帳戶中擷取產品,以及從資料來源刪除產品。

您可以使用 products 資源建立網路商店目錄,這份目錄是購物廣告中可用的產品清單。建立 Merchant Center 帳戶,並準備好透過 API 上傳第一組產品後,您就能使用 products 資源。

您有責任遵守購物廣告免費產品資訊政策。購物廣告保有強制執行這些政策的權利,如果我們發現違反這些政策的內容或行為,就會做出相應的回應。

products 資源會將產品資訊上傳至 Shopping Merchant Center 資料庫。並且提供多種方法,可讓您逐一存取、更新或刪除產品資訊,或在批次模式中一次存取多個產品資訊。

productInput 資源代表您為產品提交的輸入資料。productInput 資源必須包含下列欄位:

  • channel:產品的通路
  • offerId:產品的專屬 ID。產品輸入和處理後的產品這個值相同。
  • contentLanguage:由兩個字母組成的 ISO 639-1 語言代碼。
  • feedLabel:產品的動態饋給標籤。

雖然商家能夠使用名為「主要動態饋給」的檔案載入產品,但使用 Merchant API 建立及刪除產品仍有許多優點。這些好處包括更快速的回應時間,以及能即時更新多項產品的功能,更省去管理多個補充動態饋給的麻煩。API 呼叫的產品變更最多可能需要數小時才會顯示在 Shopping Merchant Center 資料庫中。

Google 會自動協助維護產品的特定屬性。詳情請參閱「啟用自動改善功能」。

必要條件

如果沒有資料來源,請使用 Merchant Data Sources API 建立資料來源 或 Merchant Center。

如果您已使用 Merchant Center UI 或 API 建立資料來源,可以使用 Merchant Product API 新增產品。如果您是使用 Content API for Shopping 新增產品,請參閱遷移指南,瞭解如何開始使用 Merchant Product API。

將產品輸入資料上傳至帳戶

如要將產品輸入內容上傳至帳戶,請使用 accounts.productInputs.insert 方法。您必須傳遞主要或補充資料來源的專屬 ID,才能使用 Merchant Product API 插入產品。

從您的帳戶擷取已處理的產品

如要從帳戶擷取已處理的產品,請使用 accounts.products.get 方法。插入已處理的產品後,可能需要幾分鐘的時間才會顯示。

從帳戶中刪除產品輸入內容

如要從帳戶中刪除產品輸入,請使用 accounts.productInputs.delete 方法。您必須傳遞產品所屬主要或補充資料來源的專屬 ID,才能使用 Merchant Product API 刪除產品。

列出帳戶中的產品

如要在帳戶中列出已處理的產品,請使用 accounts.products.list 方法。