本頁說明如何以程式輔助方式上傳及管理產品。使用 Merchant Products API,您可以在資料來源中插入或更新產品、從帳戶中擷取產品,以及從資料來源中刪除產品。
Merchant Products API 包含兩個資源。
productInputs
代表產品的輸入部分。products
代表從輸入部分建構的已處理產品。
productInputs
可分為主要和補充,取決於是否已上傳至主要資料來源或補充資料來源。每個 product
都會由單一主要 productInput
和任意數量的補充 productInputs
建構而成。
你可以使用 Merchant Products API 建立線上或店面目錄,這些產品可顯示在多個購物目的地中。建立 Merchant Center 帳戶、設定第一個資料來源,並準備好透過 API 上傳初始產品組合後,就可以使用 productInputs
資源。
雖然商家可以使用檔案上傳產品,也就是稱為 PrimaryProductDataSource 的檔案,但使用 Merchant API 建立及刪除產品有許多優點。這些優點包括回應時間更快,以及能夠即時更新產品,而無需管理大型檔案。透過 API 呼叫所做的產品變更,最多可能需要幾小時才會顯示在購物資料庫中。
必要條件
如果沒有資料來源,請使用 Merchant DataSources API 或 Merchant Center 建立資料來源。
如果您已使用 Merchant Center UI 或 API 建立資料來源,可以使用 Merchant Products API 新增產品。如果你使用 Content API for Shopping 新增產品,請參閱遷移指南,瞭解如何開始使用 Merchant Products API。
請務必遵守《購物廣告》和《免費產品資訊》政策。購物廣告有權執行這些政策,並在發現違反這些政策的內容或行為時採取適當回應。
資源
products
資源可讓您從 Shopping 資料庫擷取產品資訊。
productInput
資源代表您為產品提交的輸入資料。它也提供方法,讓你一次更新或刪除多個產品資訊,或在批次模式中一次更新或刪除多個產品資訊。productInput
資源必須包含下列欄位:
將產品輸入內容上傳至帳戶
如要將產品輸入內容上傳至帳戶,請使用 accounts.productInputs.insert
方法。您必須傳遞主要或補充資料來源的專屬 ID。
從帳戶中擷取已處理的產品
如要從帳戶中擷取已處理的產品,請使用 accounts.products.get
方法。插入後,系統可能需要幾分鐘的時間才能顯示已處理的產品。
您可以從 accounts.productInputs.insert
的回應中取得 product
欄位的處理產品資源名稱。
從帳戶中刪除產品輸入內容
如要從帳戶中刪除產品輸入內容,請使用 accounts.productInputs.delete
方法。如要使用 Merchant Products API 刪除產品,你必須傳遞產品所屬主要或補充資料來源的專屬 ID。
列出帳戶中的產品
如要列出帳戶中已處理的產品,請使用 accounts.products.list
方法。