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) 和破折號 (-)。

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

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

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

contentLanguage

string

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

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

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

頻道

資料來源頻道。

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

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

SupplementalProductDataSource

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

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

string

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

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

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

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

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

contentLanguage

string

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

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

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

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)

選用設定。擷取詳細資料以提供資料來源。其中包含 FETCHGOOGLE_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.Dategoogle.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

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