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
  • 建立萬用字元資料來源。萬用字元資料來源不含 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 時,只會為 您。使用 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敬上 方法。

主要產品資料來源可讓您管理預設值 資料來源規則。預設規則是套用到 屬性。建立預設規則時 資料來源,或透過預設規則更新現有資料來源 ] 欄位。

以下設定範例可確保系統會先採用所有屬性 擷取自專屬 ID 1001 的資料來源。然後缺少 則是從主要資料來源新增的屬性最終 屬性取自補充的資料來源 ID 1002 (如果尚未提供其他資料來源)。如果相同 為多個資料來源提供屬性值,清單中的值越大 已選取。

defaultRule {
 takeFromDataSources: [
   '1001', // Supplemental product data source
   'self', //  Self reference to the primary data source
   '1002' // Supplemental product data source
 ]
}

自動管理動態饋給

如要註冊您的帳戶以自動管理資料來源,請務必: 包括:

  • 如要確認您的帳戶是否符合註冊資格,請撥打 Accounts.AutofeedSettings.Get 方法。
  • 確認您的帳戶不是市集 帳戶

帳戶符合註冊資格後,您就可以使用 可自動管理資料的 Accounts.AutofeedSettings.Update 方法 資料來源啟用資料來源自動管理功能後,Google 即可自動管理資料來源 新增網路商店中的產品,並確保產品隨時更新 Google 平台

擷取檔案上傳狀態

如要取得含有檔案、擷取或試算表的資料來源狀態, 可以呼叫 FileUpload 服務的 GET 方法。為取得 系統上次在資料擷取作業期間,以非同步方式擷取資料來源的上次擷取時間 來源處理完成,請使用名稱 ID latest

GET https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/datasources/{datasourceId}/fileUploads/latest

檔案上傳狀態可能包含產品詳情,包括: 所有潛在問題。

請注意,如果檔案從未上傳過,檔案上傳狀態可能不存在。 如果在不久後立即要求,檔案上傳狀態可能會處於處理中狀態 檔案隨即會上傳