Merchant Data Source API 總覽

本頁面說明如何透過程式輔助方式建立及更新資料來源,以便插入產品。自動資料來源可讓您更輕鬆地將產品資料傳送至 Google。有了自動化資料來源,Google 就能確保使用者取得網站上相關產品的最新資訊。

Content API for Shopping 只能用於建立主要資料來源。您可以使用 Merchant Data source API 建立下列類型的資料來源:

Content API for Shopping 僅允許透過檔案輸入管理資料來源。Merchant API 可讓你管理檔案和 API 輸入內容的資料來源。

使用 Merchant Data source API 時,您可以執行以下操作:

  • 使用特定 feedLabelcontentLanguage 建立新的主要資料來源。
  • 建立萬用字元資料來源。萬用字元資料來源未設定 feedLabelcontentLanguage 欄位。萬用字元資料來源可讓您使用 feedLabelcontentLanguage 不同的組合,將產品插入資料來源。
  • 建立補充資料來源,並連結至現有的主要資料來源。
  • 設定檔案資料來源的時間表。
  • 管理 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.
    

建立新資料來源

如要使用特定 feedLabelcontentLanguage 建立新的主要資料來源,請在類型專屬設定中,設定 feedLabelcontentLanguage 欄位。例如 PrimaryProductDataSource

如要查看新建立的資料來源,請建立 GETLIST 要求。

建立新的萬用字元主要資料來源

如要建立新的萬用字元主要動態饋給,請使用 PrimaryProductDataSource 設定資料來源,且不要設定 feedLabelcontentLanguage 欄位。

使用 Content API for Shopping 時,系統只會為您建立一個 API 資料來源。使用 Merchant Data source API 時,您可以擁有多個 API 資料來源,其中某些來源可以是萬用字元。

只有含有 API 輸入的資料來源可以是萬用字元資料來源。檔案輸入不支援萬用字元的資料來源。

建立補充資料來源並連結至主要資料來源

您可以使用補充資料來源,在呼叫 accounts.productInputs.insertaccounts.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 方法。