REST Resource: accounts.dataSources

Tài nguyên: DataSource

Nguồn dữ liệu cho tài khoản Merchant Center.

Biểu diễn dưới dạng 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.
}
Trường
name

string

Giá trị nhận dạng. Tên của nguồn dữ liệu. Định dạng {datasource.name=accounts/{account}/dataSources/{datasource}}
dataSourceId

string (int64 format)

Chỉ có đầu ra. Mã nguồn dữ liệu.
displayName

string

Bắt buộc. Tên nguồn dữ liệu được hiển thị trong giao diện người dùng Merchant Center.
input

enum (Input)

Chỉ có đầu ra. Xác định loại dữ liệu đầu vào cho nguồn dữ liệu. Dựa trên thông tin đầu vào, một số chế độ cài đặt có thể không hoạt động. Bạn chỉ có thể tạo các nguồn dữ liệu chung thông qua API.
fileInput

object (FileInput)

Không bắt buộc. Trường này chỉ được dùng khi dữ liệu được quản lý thông qua một tệp.
Trường kết hợp Type. Loại nguồn dữ liệu. Type chỉ có thể là một trong những trạng thái sau đây:
primaryProductDataSource

object (PrimaryProductDataSource)

Bắt buộc. Nguồn dữ liệu chính cho các sản phẩm tại cửa hàng địa phương và sản phẩm bán trực tuyến.
supplementalProductDataSource

object (SupplementalProductDataSource)

Bắt buộc. Nguồn dữ liệu bổ sung cho các sản phẩm tại cửa hàng địa phương và trực tuyến.
localInventoryDataSource

object (LocalInventoryDataSource)

Bắt buộc. Nguồn dữ liệu kho hàng tại địa phương.
regionalInventoryDataSource

object (RegionalInventoryDataSource)

Bắt buộc. Nguồn dữ liệu kho hàng theo khu vực.
promotionDataSource

object (PromotionDataSource)

Bắt buộc. Nguồn dữ liệu chương trình khuyến mãi.

PrimaryProductDataSource

Nguồn dữ liệu chính cho các sản phẩm tại cửa hàng địa phương và trực tuyến.

Biểu diễn dưới dạng JSON 
{
  "channel": enum (Channel),
  "countries": [
    string
  ],
  "feedLabel": string,
  "contentLanguage": string
}
Trường
channel

enum (Channel)

Bắt buộc. Không thể thay đổi. Chỉ định loại kênh nguồn dữ liệu.
countries[]

string

Không bắt buộc. Các quốc gia nơi mặt hàng có thể xuất hiện. Được biểu thị dưới dạng mã lãnh thổ CLDR.
feedLabel

string

Không bắt buộc. Không thể thay đổi. Nhãn nguồn cấp dữ liệu được chỉ định ở cấp nguồn dữ liệu.

Phải nhỏ hơn hoặc bằng 20 chữ cái viết hoa (A-Z), số (0-9) và dấu gạch ngang (-).

Hãy xem thêm bài viết về việc di chuyển sang nhãn nguồn cấp dữ liệu.

Bạn phải đặt hoặc không đặt feedLabel và contentLanguage cho các nguồn dữ liệu có loại nội dung sản phẩm. Bạn phải đặt các giá trị này cho những nguồn dữ liệu có thông tin đầu vào là tệp.

Nếu bạn đặt chính sách này, nguồn dữ liệu sẽ chỉ chấp nhận những sản phẩm khớp với kiểu kết hợp này. Nếu bạn không đặt chính sách này, nguồn dữ liệu sẽ chấp nhận các sản phẩm không có quy định hạn chế đó.
contentLanguage

string

Không bắt buộc. Không thể thay đổi. Ngôn ngữ gồm hai chữ cái theo ISO 639-1 của các mục trong nguồn dữ liệu.

Bạn phải đặt hoặc không đặt cả feedLabel và contentLanguage. Bạn chỉ có thể huỷ thiết lập các trường này cho nguồn dữ liệu không có dữ liệu đầu vào.

Nếu bạn đặt chính sách này, nguồn dữ liệu sẽ chỉ chấp nhận những sản phẩm khớp với kiểu kết hợp này. Nếu bạn không đặt chính sách này, nguồn dữ liệu sẽ chấp nhận các sản phẩm không có quy định hạn chế đó.

Kênh

Kênh nguồn dữ liệu.

Kênh được dùng để phân biệt các nguồn dữ liệu cho các ngành dọc sản phẩm khác nhau.

Enum
CHANNEL_UNSPECIFIED Chưa chỉ định.
ONLINE_PRODUCTS Sản phẩm trực tuyến.
LOCAL_PRODUCTS Sản phẩm tại cửa hàng địa phương.
PRODUCTS Nguồn dữ liệu hợp nhất cho cả sản phẩm tại cửa hàng địa phương và sản phẩm trực tuyến.

SupplementalProductDataSource

Nguồn dữ liệu bổ sung cho các sản phẩm tại cửa hàng địa phương và trực tuyến.

Biểu diễn dưới dạng JSON 
{
  "feedLabel": string,
  "contentLanguage": string
}
Trường
feedLabel

string

Không bắt buộc. Không thể thay đổi. Nhãn nguồn cấp dữ liệu được chỉ định ở cấp nguồn dữ liệu.

Phải nhỏ hơn hoặc bằng 20 chữ cái viết hoa (A-Z), số (0-9) và dấu gạch ngang (-).

Hãy xem thêm bài viết về việc di chuyển sang nhãn nguồn cấp dữ liệu.

Bạn phải đặt hoặc không đặt feedLabel và contentLanguage cho các nguồn dữ liệu có loại nội dung sản phẩm. Bạn phải đặt các giá trị này cho những nguồn dữ liệu có thông tin đầu vào là tệp.

Nếu bạn đặt chính sách này, nguồn dữ liệu sẽ chỉ chấp nhận những sản phẩm khớp với kiểu kết hợp này. Nếu bạn không đặt chính sách này, nguồn dữ liệu sẽ chấp nhận các dữ liệu sản xuất mà không có hạn chế nêu trên.
contentLanguage

string

Không bắt buộc. Không thể thay đổi. Ngôn ngữ gồm hai chữ cái theo ISO 639-1 của các mục trong nguồn dữ liệu.

Bạn phải đặt hoặc không đặt cả feedLabel và contentLanguage. Bạn chỉ có thể huỷ thiết lập các trường này cho nguồn dữ liệu không có dữ liệu đầu vào.

Nếu bạn đặt chính sách này, nguồn dữ liệu sẽ chỉ chấp nhận những sản phẩm khớp với kiểu kết hợp này. Nếu bạn không đặt chính sách này, nguồn dữ liệu sẽ chấp nhận các dữ liệu sản xuất mà không có hạn chế nêu trên.

LocalInventoryDataSource

Nguồn dữ liệu kho hàng tại địa phương.

Biểu diễn dưới dạng JSON 
{
  "feedLabel": string,
  "contentLanguage": string
}
Trường
feedLabel

string

Bắt buộc. Không thể thay đổi. Nhãn nguồn cấp dữ liệu của các mặt hàng được cung cấp kho hàng tại địa phương.

Phải nhỏ hơn hoặc bằng 20 chữ cái viết hoa (A-Z), số (0-9) và dấu gạch ngang (-).

Hãy xem thêm bài viết về việc di chuyển sang nhãn nguồn cấp dữ liệu.
contentLanguage

string

Bắt buộc. Không thể thay đổi. Ngôn ngữ gồm hai chữ cái theo ISO 639-1 của các mặt hàng mà kho hàng tại địa phương được cung cấp.

RegionalInventoryDataSource

Nguồn dữ liệu kho hàng tại khu vực.

Biểu diễn dưới dạng JSON 
{
  "feedLabel": string,
  "contentLanguage": string
}
Trường
feedLabel

string

Bắt buộc. Không thể thay đổi. Nhãn nguồn cấp dữ liệu của các sản phẩm được cung cấp kho hàng tại khu vực.

Phải nhỏ hơn hoặc bằng 20 chữ cái viết hoa (A-Z), số (0-9) và dấu gạch ngang (-).

Hãy xem thêm bài viết về việc di chuyển sang nhãn nguồn cấp dữ liệu.
contentLanguage

string

Bắt buộc. Không thể thay đổi. Ngôn ngữ gồm hai chữ cái theo ISO 639-1 của các mặt hàng mà kho hàng tại khu vực được cung cấp.

PromotionDataSource

Nguồn dữ liệu về chương trình khuyến mãi.

Biểu diễn dưới dạng JSON 
{
  "targetCountry": string,
  "contentLanguage": string
}
Trường
targetCountry

string

Bắt buộc. Không thể thay đổi. Quốc gia mục tiêu được dùng trong giá trị nhận dạng duy nhất. Được biểu thị dưới dạng mã lãnh thổ CLDR.

Chương trình khuyến mãi chỉ áp dụng ở một số quốc gia.
contentLanguage

string

Bắt buộc. Không thể thay đổi. Ngôn ngữ gồm hai chữ cái theo ISO 639-1 của các mục trong nguồn dữ liệu.

Đầu vào

Xác định loại dữ liệu đầu vào cho nguồn dữ liệu. Dựa trên thông tin đầu vào, một số chế độ cài đặt có thể không được hỗ trợ.

Enum
INPUT_UNSPECIFIED Dữ liệu đầu vào chưa xác định.
API Biểu thị các nguồn dữ liệu mà dữ liệu chủ yếu được cung cấp thông qua API.
FILE Biểu thị các nguồn dữ liệu mà dữ liệu được cung cấp chủ yếu thông qua đầu vào tệp. Dữ liệu vẫn có thể được cung cấp thông qua API.
UI

Nguồn dữ liệu cho các sản phẩm được thêm trực tiếp trong Merchant Center.

Bạn chỉ có thể tạo hoặc cập nhật loại nguồn dữ liệu này thông qua API này bằng giao diện người dùng Merchant Center.

Loại nguồn dữ liệu này ở chế độ chỉ đọc.
AUTOFEED Đây còn gọi là Nguồn cấp dữ liệu tự động, dùng để tự động tạo dữ liệu sản phẩm. Bạn có thể bật hoặc tắt loại nguồn dữ liệu này thông qua gói Tài khoản.

FileInput

Dữ liệu cụ thể cho nguồn dữ liệu tệp. Trường này trống đối với dữ liệu đầu vào khác của nguồn dữ liệu.

Biểu diễn dưới dạng JSON 
{
  "fetchSettings": {
    object (FetchSettings)
  },
  "fileName": string,
  "fileInputType": enum (FileInputType)
}
Trường
fetchSettings

object (FetchSettings)

Không bắt buộc. Tìm nạp thông tin chi tiết để cung cấp nguồn dữ liệu. Tệp này chứa chế độ cài đặt cho các kiểu đầu vào tệp FETCH và GOOGLE_SHEETS. Các trường bắt buộc khác nhau tuỳ theo tần suất tìm nạp.
fileName

string

Không bắt buộc. Tên tệp của nguồn dữ liệu. Bắt buộc đối với loại tệp nhập UPLOAD.
fileInputType

enum (FileInputType)

Chỉ có đầu ra. Loại tệp đầu vào.

FetchSettings

Tìm nạp thông tin chi tiết để cung cấp nguồn dữ liệu.

Biểu diễn dưới dạng JSON 
{
  "enabled": boolean,
  "dayOfMonth": integer,
  "timeOfDay": {
    object (TimeOfDay)
  },
  "dayOfWeek": enum (DayOfWeek),
  "timeZone": string,
  "frequency": enum (Frequency),
  "fetchUri": string,
  "username": string,
  "password": string
}
Trường
enabled

boolean

Không bắt buộc. Bật hoặc tạm dừng lịch tìm nạp.
dayOfMonth

integer

Không bắt buộc. Ngày trong tháng mà tệp nguồn dữ liệu cần được tìm nạp (1–31). Bạn chỉ có thể đặt trường này cho tần suất hằng tháng.
timeOfDay

object (TimeOfDay)

Không bắt buộc. Giờ trong ngày mà tệp nguồn dữ liệu cần được tìm nạp. Thông tin về phút và giây sẽ không được hỗ trợ nên sẽ bị bỏ qua.
dayOfWeek

enum (DayOfWeek)

Không bắt buộc. Ngày trong tuần mà tệp nguồn dữ liệu cần được tìm nạp. Bạn chỉ có thể đặt trường này cho tần suất hằng tuần.
timeZone

string

Không bắt buộc. Múi giờ dùng cho lịch biểu. UTC theo mặc định. Ví dụ: "America/Los_Angeles".
frequency

enum (Frequency)

Bắt buộc. Tần suất mô tả lịch tìm nạp.
fetchUri

string

Không bắt buộc. URL mà tại đó tệp nguồn dữ liệu có thể được tìm nạp. Google Merchant Center hỗ trợ tính năng tự động tải lên theo lịch bằng các giao thức HTTP, HTTPS hoặc SFTP. Vì vậy, giá trị phải là một đường liên kết hợp lệ bằng một trong ba giao thức đó. Không thể thay đổi cho tệp Google Trang tính.
username

string

Không bắt buộc. Tên người dùng không bắt buộc cho [tìm nạp url][google.shopping.content.bundles.DataSources.FileInput.fetch_url]. Dùng để gửi nguồn dữ liệu thông qua SFTP.
password

string

Không bắt buộc. Mật khẩu không bắt buộc cho [tìm nạp url][google.shopping.content.bundles.DataSources.FileInput.fetch_url]. Dùng để gửi nguồn dữ liệu thông qua SFTP.

TimeOfDay

Đại diện cho thời gian trong ngày. Ngày và múi giờ không quan trọng hoặc được chỉ định ở nơi khác. API có thể chọn cho phép giây nhuận. Các loại có liên quan là google.type.Date và google.protobuf.Timestamp.

Biểu diễn dưới dạng JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Trường
hours

integer

Giờ trong ngày ở định dạng 24 giờ. Nên ở từ 0 đến 23. API có thể chọn cho phép giá trị "24:00:00" cho các tình huống như thời gian đóng cửa doanh nghiệp.
minutes

integer

Số phút trong ngày. Phải từ 0 đến 59.
seconds

integer

Số giây của thời gian. Giá trị thường phải từ 0 đến 59. Một API có thể cho phép giá trị 60 nếu cho phép bật-giây.
nanos

integer

Phân số giây tính bằng nano giây. Giá trị phải nằm trong khoảng từ 0 đến 999.999.999.

DayOfWeek

Đại diện cho một ngày trong tuần.

Enum
DAY_OF_WEEK_UNSPECIFIED Ngày trong tuần không được chỉ định.
MONDAY Thứ Hai
TUESDAY Thứ Ba
WEDNESDAY Thứ Tư
THURSDAY Thursday (thứ Năm)
FRIDAY Thứ Sáu
SATURDAY Saturday (thứ Bảy)
SUNDAY Chủ Nhật

Tần số

Các trường bắt buộc khác nhau tuỳ theo tần suất tìm nạp. Đối với lịch tìm nạp hằng tháng, bạn phải nhập [ngày trong tháng][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_month] và [giờ trong ngày][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day]. Đối với lịch tìm nạp hằng tuần, bạn phải nhập [ngày trong tuần][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_week] và [giờ trong ngày][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day]. Đối với lịch tìm nạp hằng ngày, bạn chỉ cần nhập [giờ trong ngày][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day].

Enum
FREQUENCY_UNSPECIFIED Chưa chỉ định tần suất.
FREQUENCY_DAILY Quá trình tìm nạp diễn ra hằng ngày.
FREQUENCY_WEEKLY Quá trình tìm nạp diễn ra hằng tuần.
FREQUENCY_MONTHLY Quá trình tìm nạp diễn ra hằng tháng.

FileInputType

Phương thức phân phối tệp.

Enum
FILE_INPUT_TYPE_UNSPECIFIED Chưa xác định loại tệp nhập.
UPLOAD Tệp được tải lên thông qua SFTP, Google Cloud Storage hoặc theo cách thủ công trong Merchant Center.
FETCH Tệp này được tìm nạp từ [fetchUri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri] đã định cấu hình.
GOOGLE_SHEETS Tệp này được tìm nạp từ Google Trang tính được chỉ định trong [fetchUri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri].

Phương thức

create

 Tạo cấu hình nguồn dữ liệu mới cho tài khoản cụ thể.

delete

 Xoá nguồn dữ liệu khỏi tài khoản Merchant Center.

fetch

 Thực hiện tìm nạp dữ liệu ngay lập tức (kể cả bên ngoài lịch tìm nạp) trên một nguồn dữ liệu từ tài khoản Merchant Center của bạn.

get

 Truy xuất cấu hình nguồn dữ liệu cho tài khoản cụ thể.

list

 Liệt kê cấu hình của các nguồn dữ liệu của một tài khoản cụ thể.

patch

 Cập nhật cấu hình nguồn dữ liệu hiện có.