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)
  }
  // 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 UI 中顯示的資料來源名稱。
input

enum (Input)

僅供輸出。決定資料來源的輸入類型。視輸入方式而定，某些設定可能無法運作。只有一般資料來源可透過 API 建立。
fileInput

object (FileInput)

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

object (PrimaryProductDataSource)

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

object (SupplementalProductDataSource)

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

object (LocalInventoryDataSource)

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

object (RegionalInventoryDataSource)

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

object (PromotionDataSource)

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

PrimaryProductDataSource

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

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

enum (Channel)

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

string

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

string

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

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

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

對於含有產品內容類型的資料來源，您必須同時設定 feedLabel 和 contentLanguage 或未設定。必須為含有檔案輸入的資料來源進行設定。

如果設定，資料來源只會接受與這個組合相符的產品。如未設定，資料來源將接受沒有該限制的產品。
contentLanguage

string

選用設定。不可變動。資料來源中項目的 ISO 639-1 語言，由兩個英文字母表示。

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

如果設定，資料來源只會接受與這個組合相符的產品。如未設定，資料來源將接受沒有該限制的產品。

頻道

資料來源頻道。

管道可用來區分不同產業的資料來源。

列舉
CHANNEL_UNSPECIFIED 不指定。
ONLINE_PRODUCTS 線上產品。
LOCAL_PRODUCTS 店面產品。
PRODUCTS 店面和線上產品的整合式資料來源。注意：這個頻道無法透過 API 管理產品。

SupplementalProductDataSource

店面和線上產品的補充資料來源。

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

string

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

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

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

對於含有產品內容類型的資料來源，您必須同時設定 feedLabel 和 contentLanguage 或未設定。必須為含有檔案輸入的資料來源進行設定。

如果設定，資料來源只會接受與這個組合相符的產品。如未設定，資料來源將接受不受該限制影響的產品。
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 語言，由兩個英文字母表示。

輸入

決定資料來源的輸入類型。部分輸入設定可能不支援某些設定。

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

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

您只能透過 Merchant Center UI 建立或更新這類資料來源。

這類資料來源為唯讀。
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

選用設定。排程使用的時區。根據預設，世界標準時間。例如「America/Los_Angeles」。
frequency

enum (Frequency)

必要欄位。說明擷取時間表的頻率。
fetchUri

string

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

string

選用設定。[擷取網址][google.shopping.content.bundles.DataSources.FileInput.fetch_url] 的使用者名稱 (選用)。用於透過 SFTP 提交資料來源。
password

string

選用設定。[擷取網址][google.shopping.content.bundles.DataSources.FileInput.fetch_url] 的選用密碼。用於透過 SFTP 提交資料來源。

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 檔案是透過 SFTP、Google Cloud Storage 上傳，或是在 Merchant Center 中手動上傳。
FETCH 系統會從已設定的 [fetchUri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri] 中擷取這個檔案。
GOOGLE_SHEETS 系統會從 [fetchUri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri] 中指定的 Google 試算表擷取此檔案。

方法

create

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

delete

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

fetch

 這個外掛程式能立即對 Merchant Center 帳戶中的資料來源執行資料擷取作業 (即使是擷取時間表以外)。

get

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

list

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

patch

 更新現有的資料來源設定。