本頁說明如何透過程式建立及更新資料來源，以便插入產品。自動資料來源可讓你輕鬆將產品資料傳送給 Google。自動化資料來源可確保 Google 取得商家網站上相關產品的最新資訊。
Content API for Shopping 只允許你建立主要資料來源。您可以使用 Merchant Data sources API 建立下列類型的資料來源：
你只能透過檔案輸入來管理 Content API for Shopping 的資料來源。Merchant API 可讓你透過檔案和 API 輸入內容管理資料來源。
使用 Merchant Data sources API，您可以執行下列操作：
- 使用特定
feedLabel建立新的主要資料來源，並contentLanguage。 - 建立未設定
feedLabel和contentLanguage欄位的資料來源。使用這類資料來源，您可以為產品指定多個國家/地區，因為您可以在單一資料來源中插入具有不同feedLabel和contentLanguage組合的產品。 - 建立補充資料來源，並連結至現有的主要資料來源。
- 設定檔案資料來源的時間表。
- 註冊帳戶，自動管理資料來源。
- 管理 API 資料來源。
- 使用主要產品資料來源管理資料來源的預設規則。
- 使用其他類型的資料來源，例如促銷活動。
您無法使用 Merchant 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.
建立新資料來源
主要資料來源是 Merchant Center 的主要資料來源 廣告空間。你只能使用主要資料來源新增或移除產品。如果 您在主要資料來源中新增的每項產品，都會符合 Merchant Center 的資料 和資格規定，您不再需要建立其他資料來源。
如何使用特定 feedLabel 和
contentLanguage，請設定 feedLabel 和 contentLanguage 欄位的
專屬設定如要進一步瞭解這些欄位
請參閱 PrimaryProductDataSource。
如要進一步瞭解如何建立資料來源，請參閱 accounts.dataSources.create 方法。
如要查看新建立的資料來源，請使用 accounts.dataSources.get 或 accounts.dataSources.list 方法。
建立新的主要資料來源，以便指定多個國家/地區
如要建立新的主要動態饋給，以便指定多個國家/地區，請使用 PrimaryProductDataSource 設定資料來源，但不要設定 feedLabel 和 contentLanguage 欄位。
使用 Content API for Shopping 時，系統只會為您建立一個 API 資料來源。使用 Merchant Data source API 時，您可以有多個 API 資料來源
其中一些可以不需要設定 feedLabel 和 contentLanguage 欄位。
只有含有 API 輸入的資料來源可以不含 feedLabel 和
已設定 contentLanguage 個欄位。檔案不支援這類資料來源
輸入內容
建立補充資料來源，並連結至主要資料來源
補充資料來源只能用於更新一或多個主要資料來源中的既有產品資料。可以有多個補充 不同資料來源，各自能補充任意數量的主要資料 資料來源
您可以使用補充資料來源，在呼叫 accounts.productInputs.insert 和 accounts.productInputs.delete 方法時，將資料來源的專屬 ID 新增為查詢參數，藉此對產品資料進行部分更新。你只能使用補充資料來源更新現有產品。
如要建立補充資料來源，請使用
請SupplementalProductDataSource，然後更新 defaultRule 以建立連結
欄位的值
補充檔案資料來源必須有 feedLabel 和 contentLanguage
欄位。補充 API 資料來源必須一律未設定 feedLabel 和 contentLanguage 欄位。
為檔案資料來源設定時間表
如要為檔案動態饋給設定時間表，請使用 FileInput 欄位將資料來源設為檔案資料來源，然後使用 FileInput.FetchSettings 欄位設定 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.getAutofeedSettings方法。 - 請確認你的帳戶不是市集帳戶。
帳戶符合註冊資格後，您就可以使用
accounts.autofeedSettings.updateAutofeedSettings
方法，啟用資料來源的自動管理。啟用資料來源的自動管理功能後，Google 就會自動新增網路商店中的產品，確保產品在 Google 平台上隨時保持最新狀態。
擷取檔案上傳狀態
如要透過檔案、擷取或試算表取得資料來源的狀態，您可以呼叫 accounts.dataSources.fileUploads 服務的 GET 方法。如要在資料來源處理完成後，取得以非同步方式計算的資料來源最後一次擷取結果，請使用名稱 ID latest。
GET https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/datasources/{datasourceId}/fileUploads/latest
檔案上傳狀態可能會顯示產品的詳細資料，包括任何潛在問題。
請注意，如果檔案從未上傳，檔案上傳狀態可能不存在。如果在檔案上傳後立即要求，檔案上傳狀態可能會處於處理狀態。