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 執行下列操作：

  • 使用特定 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 時，只會為 您。使用 Merchant Data source API 時，您可以有多個 API 資料來源 其中一些屬於萬用字元

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

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

您可以使用補充資料來源，對產品資料進行部分更新。 並在過程中將資料來源的專屬 ID 新增為查詢參數 呼叫 accounts.productInputs.insert敬上 和 accounts.productInputs.delete。 方法。你只能使用補充資料來源更新現有的產品。

如要建立補充資料來源，請使用 SupplementalProductDataSource，然後更新 defaultRule 以建立連結 欄位的值

補充檔案資料來源不得含有萬用字元資料來源。補充 API 資料來源一律須為萬用字元資料來源。

為檔案資料來源設定時間表

如要設定檔案動態饋給的排程，請將資料來源設為檔案 然後使用 FileInput 欄位完成設定 fetchsettings 使用 FileInput.FetchSettings 欄位

刪除資料來源

如要從帳戶中刪除現有的資料來源，請使用 accounts.dataSources.delete敬上 方法。

擷取資料來源

如要擷取資料來源中設定的檔案，請使用 accounts.dataSources.fetch敬上 方法。這個方法會立即在資料來源上執行資料擷取作業： 即可。這個方法僅適用於含有檔案輸入集的資料來源。

取得資料來源

如要擷取帳戶的資料來源設定，請使用 accounts.dataSources.get敬上 方法。

列出資料來源

如要列出帳戶的資料來源設定，請使用 accounts.dataSources.list敬上 方法。

修補資料來源

如要更新現有資料來源的設定，請使用 accounts.dataSources.patch敬上 方法。