本頁面說明如何透過程式輔助方式建立及更新資料來源,以便插入產品。自動資料來源可讓您更輕鬆地將產品資料傳送至 Google。有了自動化資料來源,Google 就能確保使用者取得網站上相關產品的最新資訊。
Content API for Shopping 只能用於建立主要資料來源。您可以使用 Merchant Data source API 建立下列類型的資料來源:
Content API for Shopping 僅允許透過檔案輸入管理資料來源。Merchant API 可讓你管理檔案和 API 輸入內容的資料來源。
使用 Merchant Data source API 時,您可以執行以下操作:
- 使用特定
feedLabel
和contentLanguage
建立新的主要資料來源。 - 建立萬用字元資料來源。萬用字元資料來源未設定
feedLabel
和contentLanguage
欄位。萬用字元資料來源可讓您使用feedLabel
和contentLanguage
不同的組合,將產品插入資料來源。 - 建立補充資料來源,並連結至現有的主要資料來源。
- 設定檔案資料來源的時間表。
- 管理 API 資料來源。
- 使用其他類型的資料來源,例如促銷活動。
先備知識
- 您的帳戶已遷移至單一語言代碼動態饋給。
如要確認帳戶是否已遷移至資料目標分割,請使用資料來源清單或 get 方法。如果您不符合計畫資格,就會收到下列例外狀況訊息,且應與支援團隊聯絡。
This account is in the data sources migration process and can't be used with this API yet. Contact support for more info on when this account will be able to use the data sources endpoint.
建立新資料來源
如要使用特定 feedLabel
和 contentLanguage
建立新的主要資料來源,請在類型專屬設定中,設定 feedLabel
和 contentLanguage
欄位。例如 PrimaryProductDataSource
。
如要查看新建立的資料來源,請建立 GET
或 LIST
要求。
建立新的萬用字元主要資料來源
如要建立新的萬用字元主要動態饋給,請使用 PrimaryProductDataSource
設定資料來源,且不要設定 feedLabel
和 contentLanguage
欄位。
使用 Content API for Shopping 時,系統只會為您建立一個 API 資料來源。使用 Merchant Data source API 時,您可以擁有多個 API 資料來源,其中某些來源可以是萬用字元。
只有含有 API 輸入的資料來源可以是萬用字元資料來源。檔案輸入不支援萬用字元的資料來源。
建立補充資料來源並連結至主要資料來源
您可以使用補充資料來源,在呼叫 accounts.productInputs.insert
和 accounts.productInputs.delete
方法時,將資料來源的專屬 ID 新增為查詢參數,對產品資料進行部分更新。你只能使用補充資料來源更新現有的產品。
如要建立補充資料來源,請使用 SupplementalProductDataSource
設定資料來源,然後更新主要資料來源的 defaultRule
欄位以建立連結。
補充檔案資料來源不得含有萬用字元資料來源。補充 API 資料來源一律必須為萬用字元資料來源。
為檔案資料來源設定時間表
如要為檔案動態饋給設定排程,請使用 FileInput
欄位將資料來源設為檔案資料來源,然後使用 FileInput.FetchSettings
欄位設定 fetchsettings
。
刪除資料來源
如要從帳戶中刪除現有資料來源,請使用 accounts.dataSources.delete
方法。
擷取資料來源
如要擷取資料來源中設定的檔案,請使用 accounts.dataSources.fetch
方法。這個方法會立即從您帳戶的資料來源執行資料擷取作業。這個方法僅適用於含有檔案輸入集的資料來源。
取得資料來源
如要擷取帳戶的資料來源設定,請使用 accounts.dataSources.get
方法。
列出資料來源
如要列出帳戶的資料來源設定,請使用 accounts.dataSources.list
方法。
修補資料來源
如要更新現有資料來源的設定,請使用 accounts.dataSources.patch
方法。