REST Resource: accounts.dataSources

資源：DataSource

Merchant Center 帳戶的資料來源。

JSON 表示法 
{
  "name": string,
  "dataSourceId": string,
  "displayName": string,
  "input": enum (Input),
  "fileInput": {
    object (FileInput)
  },

  // Union field Type can be only one of the following:
  "primaryProductDataSource": {
    object (PrimaryProductDataSource)
  },
  "supplementalProductDataSource": {
    object (SupplementalProductDataSource)
  },
  "localInventoryDataSource": {
    object (LocalInventoryDataSource)
  },
  "regionalInventoryDataSource": {
    object (RegionalInventoryDataSource)
  },
  "promotionDataSource": {
    object (PromotionDataSource)
  },
  "productReviewDataSource": {
    object (ProductReviewDataSource)
  },
  "merchantReviewDataSource": {
    object (MerchantReviewDataSource)
  }
  // End of list of possible types for union field Type.
}
欄位
name

string

ID。資料來源的名稱。格式：{datasource.name=accounts/{account}/dataSources/{datasource}}
dataSourceId

string (int64 format)

僅供輸出。資料來源 ID。
displayName

string

必要欄位。Merchant Center 使用者介面中顯示的資料來源名稱。
input

enum (Input)

僅供輸出。決定資料來源的輸入類型。根據輸入內容，部分設定可能無法運作。您只能透過 API 建立一般資料來源。
fileInput

object (FileInput)

選用設定。只有在透過檔案管理資料時，才會使用這個欄位。
聯集欄位 Type。資料來源類型。Type 只能是下列其中一項：
primaryProductDataSource

object (PrimaryProductDataSource)

必要欄位。店面和線上產品的主要資料來源。
supplementalProductDataSource

object (SupplementalProductDataSource)

必要欄位。店面和線上產品的補充資料來源。
localInventoryDataSource

object (LocalInventoryDataSource)

必要欄位。店面商品目錄資料來源。
regionalInventoryDataSource

object (RegionalInventoryDataSource)

必要欄位。區域商品目錄資料來源。
promotionDataSource

object (PromotionDataSource)

必要欄位。促銷活動資料來源。
productReviewDataSource

object (ProductReviewDataSource)

必要欄位。「產品評論」資料來源。
merchantReviewDataSource

object (MerchantReviewDataSource)

必要欄位。「商家評論」資料來源。

PrimaryProductDataSource

店面和線上產品的主要資料來源。

JSON 表示法 
{
  "channel": enum (Channel),
  "countries": [
    string
  ],
  "defaultRule": {
    object (DefaultRule)
  },
  "feedLabel": string,
  "contentLanguage": string
}
欄位
channel

enum (Channel)

必要欄位。不可變動。指定資料來源管道的類型。
countries[]

string

選用設定。商品可能會顯示的國家/地區。以 CLDR 地域代碼表示。
defaultRule

object (DefaultRule)

選用設定。資料來源的預設規則管理。如果已設值，系統會取代已連結的資料來源。
feedLabel

string

選用設定。不可變動。在資料來源層級指定的動態饋給標籤。

必須少於或等於 20 個大寫字母 (A-Z)、數字 (0-9) 和破折號 (-)。

另請參閱遷移至動態饋給標籤。

對於含有產品內容類型的資料來源，feedLabel 和 contentLanguage 必須同時設為或取消設定。必須為使用檔案輸入的資料來源設定這些屬性。

如果設定了這個值，資料來源只會接受符合此組合的產品。如果未設定，資料來源就會接受沒有這項限制的產品。
contentLanguage

string

選用設定。不可變動。資料來源中商品的雙字母 ISO 639-1 語言代碼。

feedLabel 和 contentLanguage 必須同時設為或取消設定。只有沒有檔案輸入的資料來源才能取消設定這些欄位。

如果設定了這個值，資料來源只會接受符合此組合的產品。如果未設定，資料來源就會接受沒有這項限制的產品。

頻道

資料來源管道。

管道用於區分不同產品類別的資料來源。

列舉
CHANNEL_UNSPECIFIED 不指定。
ONLINE_PRODUCTS 線上產品。
LOCAL_PRODUCTS 店面產品。
PRODUCTS 統一資料來源，適用於店面和線上產品。注意：這個管道無法透過 API 管理產品。

預設規則

資料來源的預設規則管理。

JSON 表示法 
{
  "takeFromDataSources": [
    {
      object (DataSourceReference)
    }
  ]
}
欄位
takeFromDataSources[]

object (DataSourceReference)

必要欄位。在預設規則中連結的資料來源清單。此清單會依據彙整資料的預設規則優先順序排序。可能會包含 self 和補充資料來源的零個或多個參照。

清單不得留空。

如要將資料來源連結至預設規則，您必須在這個清單中依序新增參照。

如要將資料來源與預設規則解除連結，您必須從這份清單中移除指定的參照。

變更這個清單的順序，會導致預設規則中資料來源的優先順序也跟著變更。

舉例來說，提供以下清單 [1001, self] 會採用額外資料來源 1001 的屬性值，如果屬性未在 1001 中設定，則會改用 self。

DataSourceReference

資料來源參照可用於管理資料來源服務中的相關資料來源。

JSON 表示法 
{

  // Union field data_source_id can be only one of the following:
  "self": boolean,
  "primaryDataSourceName": string,
  "supplementalDataSourceName": string
  // End of list of possible types for union field data_source_id.
}
欄位

聯集欄位 data_source_id。

data_source_id 只能是下列其中一項：
self

boolean

應使用 Self 參照主要資料來源本身。
primaryDataSourceName

string

選用設定。主要資料來源的名稱。格式：accounts/{account}/dataSources/{datasource}
supplementalDataSourceName

string

選用設定。補充資料來源的名稱。格式：accounts/{account}/dataSources/{datasource}

SupplementalProductDataSource

店面和網路產品的補充資料來源。建立補充產品資料來源後，請務必將其連結至一或多個主要產品資料來源。

JSON 表示法 
{
  "referencingPrimaryDataSources": [
    {
      object (DataSourceReference)
    }
  ],
  "feedLabel": string,
  "contentLanguage": string
}
欄位
referencingPrimaryDataSources[]

object (DataSourceReference)

僅供輸出。在預設或自訂規則中，與這個資料來源連結的所有主要資料來源 (已排序且去重複) 清單。在移除所有連結之前，無法刪除輔助資料來源。
feedLabel

string

選用設定。不可變動。在資料來源層級指定的動態饋給標籤。

必須少於或等於 20 個大寫字母 (A-Z)、數字 (0-9) 和破折號 (-)。

另請參閱遷移至動態饋給標籤。

如果資料來源的內容類型為產品，feedLabel 和 contentLanguage 必須同時設為或取消設定。

必須為含有 file input 的資料來源設定這些屬性。對於沒有 file input 的資料來源，必須取消設定這些欄位。

如果設定了這個值，資料來源只會接受符合此組合的產品。如果未設定，資料來源就會接受沒有限制的產品。
contentLanguage

string

選用設定。不可變動。資料來源中商品的雙字母 ISO 639-1 語言代碼。

feedLabel 和 contentLanguage 必須同時設為或取消設定。只有沒有檔案輸入的資料來源才能取消設定這些欄位。

如果設定了這個值，資料來源只會接受符合此組合的產品。如果未設定，資料來源就會接受沒有限制的產品。

LocalInventoryDataSource

店面商品目錄資料來源。

JSON 表示法 
{
  "feedLabel": string,
  "contentLanguage": string
}
欄位
feedLabel

string

必要欄位。不可變動。提供店面商品目錄的商品動態饋給標籤。

必須少於或等於 20 個大寫字母 (A-Z)、數字 (0-9) 和破折號 (-)。

另請參閱遷移至動態饋給標籤。
contentLanguage

string

必要欄位。不可變動。提供店面商品目錄的商品的雙字母 ISO 639-1 語言。

RegionalInventoryDataSource

區域商品目錄資料來源。

JSON 表示法 
{
  "feedLabel": string,
  "contentLanguage": string
}
欄位
feedLabel

string

必要欄位。不可變動。提供區域商品目錄的商品動態饋給標籤。

必須少於或等於 20 個大寫字母 (A-Z)、數字 (0-9) 和破折號 (-)。

另請參閱遷移至動態饋給標籤。
contentLanguage

string

必要欄位。不可變動。提供區域商品目錄的商品，其 ISO 639-1 語言代碼為雙字母。

PromotionDataSource

促銷活動資料來源。

JSON 表示法 
{
  "targetCountry": string,
  "contentLanguage": string
}
欄位
targetCountry

string

必要欄位。不可變動。用於專屬 ID 的目標國家/地區。以 CLDR 地域代碼表示。

促銷活動僅適用於特定國家/地區。
contentLanguage

string

必要欄位。不可變動。資料來源中商品的雙字母 ISO 639-1 語言代碼。

ProductReviewDataSource

這個類型沒有任何欄位。

產品評論資料來源。

MerchantReviewDataSource

這個類型沒有任何欄位。

商家評論資料來源。

輸入

決定資料來源的輸入類型。系統可能無法支援部分輸入設定。

列舉
INPUT_UNSPECIFIED 未指定輸入內容。
API 代表資料來源，其資料主要透過 API 提供。
FILE 代表資料來源，這些來源主要透過檔案輸入提供資料。但您仍可透過 API 提供資料。
UI

直接在 Merchant Center 中新增的產品資料來源。

這類資料來源只能透過 Merchant Center 使用者介面建立或更新，無法透過這個 API 操作。

這類資料來源為唯讀。
AUTOFEED 這也稱為「自動動態饋給」，用於自動建立產品資料。您可以透過帳戶套件啟用或停用這類資料來源。

FileInput

檔案資料來源專屬資料。其他資料來源輸入內容的這個欄位會留空。

JSON 表示法 
{
  "fetchSettings": {
    object (FetchSettings)
  },
  "fileName": string,
  "fileInputType": enum (FileInputType)
}
欄位
fetchSettings

object (FetchSettings)

選用設定。擷取詳細資料以提供資料來源。其中包含 FETCH 和 GOOGLE_SHEETS 檔案輸入類型的設定。必要欄位會因擷取頻率而異。
fileName

string

選用設定。資料來源的檔案名稱。此為 UPLOAD 檔案輸入類型的必填欄位。
fileInputType

enum (FileInputType)

僅供輸出。檔案輸入類型。

FetchSettings

擷取詳細資料以提供資料來源。

JSON 表示法 
{
  "enabled": boolean,
  "dayOfMonth": integer,
  "timeOfDay": {
    object (TimeOfDay)
  },
  "dayOfWeek": enum (DayOfWeek),
  "timeZone": string,
  "frequency": enum (Frequency),
  "fetchUri": string,
  "username": string,
  "password": string
}
欄位
enabled

boolean

選用設定。啟用或暫停擷取時間表。
dayOfMonth

integer

選用設定。應擷取資料來源檔案的月份 (1-31)。這個欄位只能設定月展示頻率。
timeOfDay

object (TimeOfDay)

選用設定。應擷取資料來源檔案的一天中的時段。系統不支援分鐘和秒數，並會略過這兩個值。
dayOfWeek

enum (DayOfWeek)

選用設定。應擷取資料來源檔案的星期幾。這個欄位只能設定為每週頻率。
timeZone

string

選用設定。排程使用的時區。預設為世界標準時間 (UTC)。例如「America/Los_Angeles」。
frequency

enum (Frequency)

必要欄位。描述擷取排程的頻率。
fetchUri

string

選用設定。可擷取資料來源檔案的網址。Google Merchant Center 支援使用 HTTP、HTTPS 或 SFTP 通訊協定自動安排上傳作業，因此這個值必須是使用這三種通訊協定之一的有效連結。不可變更的 Google 試算表檔案。
username

string

選用設定。fetchUri 的選用使用者名稱。用於透過安全檔案傳輸通訊協定提交資料來源。
password

string

選用設定。fetchUri 的選用密碼。用於透過安全檔案傳輸通訊協定提交資料來源。

TimeOfDay

代表一天中的時間。日期和時區並不需要指定，或是在其他位置上指定。API 可選擇允許閏秒。相關類型為 google.type.Date 和 google.protobuf.Timestamp。

JSON 表示法 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
欄位
hours

integer

一天中的小時，採用 24 小時制。必須大於或等於 0，且通常必須小於或等於 23。API 可選擇允許使用「24:00:00」這類的值來表示營業打烊時間等情況。
minutes

integer

小時內的分鐘。必須大於或等於 0，且小於或等於 59。
seconds

integer

分鐘的秒數。必須大於或等於 0，且通常必須小於或等於 59。如果 API 允許閏秒，則可允許值為 60。
nanos

integer

秒數的小數，以奈秒為單位。必須大於或等於 0，且小於或等於 999,999,999。

DayOfWeek

代表星期幾。

列舉
DAY_OF_WEEK_UNSPECIFIED 未指定星期幾。
MONDAY 星期一
TUESDAY 週二
WEDNESDAY 週三
THURSDAY 週四
FRIDAY Friday (週五)
SATURDAY Saturday (週六)
SUNDAY 星期日

頻率

必要欄位會因擷取頻率而異。如要使用每月擷取時間表，就必須提供 [日] ([google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_month]) 和 [時] ([google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day])。如要使用每週擷取時間表，就必須提供 [星期幾][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_week] 和 [時段][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day]。對於每日擷取時間表，只需要 [日間小時][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day]。

列舉
FREQUENCY_UNSPECIFIED 未指定頻率。
FREQUENCY_DAILY 擷取作業每天都會執行。
FREQUENCY_WEEKLY 擷取作業每週執行一次。
FREQUENCY_MONTHLY 擷取作業會每月執行一次。

FileInputType

檔案提交方式。

列舉
FILE_INPUT_TYPE_UNSPECIFIED 未指定檔案輸入類型。
UPLOAD 檔案會透過安全檔案傳輸通訊協定、Google Cloud Storage 或 Merchant Center 手動上傳。
FETCH 系統會從已設定的 fetchUri 擷取檔案。
GOOGLE_SHEETS 系統會從 fetchUri 中指定的 Google 試算表擷取檔案。

方法

create

 為指定帳戶建立新的資料來源設定。

delete

 從 Merchant Center 帳戶中刪除資料來源。

fetch

 在 Merchant Center 帳戶的資料來源上立即執行資料擷取作業 (即使不在擷取時間表中也一樣)。

get

 擷取指定帳戶的資料來源設定。

list

 列出指定帳戶的資料來源設定。

patch

 更新現有資料來源設定。