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)
  },
  "productReviewDataSource": {
    object (ProductReviewDataSource)
  },
  "merchantReviewDataSource": {
    object (MerchantReviewDataSource)
  }
  // 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 xuất hiện trong giao diện người dùng của 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 dữ liệu đầu vào, một số chế độ cài đặt có thể không hoạt động. Bạn chỉ có thể tạo 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 hợp hợp nhất Type. Loại nguồn dữ liệu. Type chỉ có thể là một trong những giá trị sau:
primaryProductDataSource

object (PrimaryProductDataSource)

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

object (SupplementalProductDataSource)

Bắt buộc. Nguồn dữ liệu bổ sung cho sản phẩm tại cửa hàng địa phương và sản phẩm 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.
productReviewDataSource

object (ProductReviewDataSource)

Bắt buộc. Nguồn dữ liệu bài đánh giá sản phẩm.
merchantReviewDataSource

object (MerchantReviewDataSource)

Bắt buộc. Nguồn dữ liệu bài đánh giá của người bán.

PrimaryProductDataSource

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

Biểu diễn dưới dạng JSON 
{
  "channel": enum (Channel),
  "countries": [
    string
  ],
  "defaultRule": {
    object (DefaultRule)
  },
  "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. Quốc gia nơi các mặt hàng có thể xuất hiện. Được biểu thị dưới dạng mã lãnh thổ CLDR.
defaultRule

object (DefaultRule)

Không bắt buộc. Quản lý quy tắc mặc định của nguồn dữ liệu. Nếu bạn đặt giá trị này, các nguồn dữ liệu được liên kết sẽ được thay thế.
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.

Không được vượt quá 20 chữ cái viết hoa (A-Z), số (0-9) và dấu gạch ngang (-).

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

Bạn phải đặt hoặc huỷ đặt cả 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 thiết lập các giá trị này cho các nguồn dữ liệu có dữ liệu đầu vào là tệp.

Nếu bạn đặt giá trị này, nguồn dữ liệu sẽ chỉ chấp nhận những sản phẩm khớp với tổ hợp này. Nếu bạn không đặt chính sách này, thì nguồn dữ liệu sẽ chấp nhận những 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ữ theo tiêu chuẩn ISO 639-1 gồm hai chữ cái của các mặt hàng trong nguồn dữ liệu.

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

Nếu bạn đặt giá trị này, nguồn dữ liệu sẽ chỉ chấp nhận những sản phẩm khớp với tổ hợp này. Nếu bạn không đặt chính sách này, thì nguồn dữ liệu sẽ chấp nhận những 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.

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. Lưu ý: Bạn không thể quản lý sản phẩm thông qua API cho kênh này.

DefaultRule

Quản lý quy tắc mặc định của nguồn dữ liệu.

Biểu diễn dưới dạng JSON 
{
  "takeFromDataSources": [
    {
      object (DataSourceReference)
    }
  ]
}
Trường
takeFromDataSources[]

object (DataSourceReference)

Bắt buộc. Danh sách các nguồn dữ liệu được liên kết trong quy tắc mặc định. Danh sách này được sắp xếp theo mức độ ưu tiên của quy tắc mặc định khi kết hợp dữ liệu. Tệp này có thể không có hoặc có nhiều tệp tham chiếu đến self và các nguồn dữ liệu bổ sung.

Danh sách không được để trống.

Để liên kết nguồn dữ liệu với quy tắc mặc định, bạn cần thêm một tệp đối chiếu mới vào danh sách này (theo thứ tự tuần tự).

Để huỷ liên kết nguồn dữ liệu khỏi quy tắc mặc định, bạn cần xoá tệp đối chiếu đã cho khỏi danh sách này.

Việc thay đổi thứ tự của danh sách này sẽ làm thay đổi mức độ ưu tiên của các nguồn dữ liệu trong quy tắc mặc định.

Ví dụ: việc cung cấp danh sách sau: [1001, self] sẽ lấy giá trị thuộc tính từ nguồn dữ liệu bổ sung 1001 và dự phòng thành self nếu thuộc tính không được đặt trong 1001.

DataSourceReference

Bạn có thể sử dụng tệp tham chiếu nguồn dữ liệu để quản lý các nguồn dữ liệu có liên quan trong dịch vụ nguồn dữ liệu.

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

Trường hợp hợp nhất data_source_id.

data_source_id chỉ có thể là một trong những giá trị sau:
self

boolean

Bạn nên sử dụng Self để tham chiếu chính nguồn dữ liệu chính.
primaryDataSourceName

string

Không bắt buộc. Tên của nguồn dữ liệu chính. Định dạng accounts/{account}/dataSources/{datasource}
supplementalDataSourceName

string

Không bắt buộc. Tên của nguồn dữ liệu bổ sung. Định dạng accounts/{account}/dataSources/{datasource}

SupplementalProductDataSource

Nguồn dữ liệu bổ sung cho sản phẩm tại cửa hàng địa phương và sản phẩm trực tuyến. Sau khi tạo, bạn phải nhớ liên kết nguồn dữ liệu sản phẩm bổ sung với một hoặc nhiều nguồn dữ liệu sản phẩm chính.

Biểu diễn dưới dạng JSON 
{
  "referencingPrimaryDataSources": [
    {
      object (DataSourceReference)
    }
  ],
  "feedLabel": string,
  "contentLanguage": string
}
Trường
referencingPrimaryDataSources[]

object (DataSourceReference)

Chỉ có đầu ra. Danh sách (không theo thứ tự và đã loại bỏ trùng lặp) tất cả nguồn dữ liệu chính được liên kết với nguồn dữ liệu này trong quy tắc mặc định hoặc quy tắc tuỳ chỉnh. Bạn không thể xoá nguồn dữ liệu bổ sung trước khi xoá tất cả đường liên kết.
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.

Không được vượt quá 20 chữ cái viết hoa (A-Z), số (0-9) và dấu gạch ngang (-).

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

Bạn phải đặt hoặc huỷ đặt cả 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 các nguồn dữ liệu có file input. Bạn phải đặt lại các trường cho những nguồn dữ liệu không có file input.

Nếu bạn đặt giá trị này, nguồn dữ liệu sẽ chỉ chấp nhận những sản phẩm khớp với tổ hợp này. Nếu bạn không đặt giá trị, 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ữ theo tiêu chuẩn ISO 639-1 gồm hai chữ cái của các mặt hàng trong nguồn dữ liệu.

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

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

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 mà bạn cung cấp kho hàng tại địa phương.

Không được vượt quá 20 chữ cái viết hoa (A-Z), số (0-9) và dấu gạch ngang (-).

Xem thêm bài viết 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ữ theo tiêu chuẩn ISO 639-1 gồm hai chữ cái của các mặt hàng mà bạn cung cấp kho hàng tại địa phương.

RegionalInventoryDataSource

Nguồn dữ liệu kho hàng theo 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 mặt hàng mà bạn cung cấp kho hàng tại khu vực.

Không được vượt quá 20 chữ cái viết hoa (A-Z), số (0-9) và dấu gạch ngang (-).

Xem thêm bài viết 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ữ theo tiêu chuẩn ISO 639-1 gồm hai chữ cái của các mặt hàng mà bạn cung cấp kho hàng theo khu vực.

PromotionDataSource

Nguồn dữ liệu 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ỉ được cung cấp ở một số quốc gia.
contentLanguage

string

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

ProductReviewDataSource

Loại này không có trường nào.

Nguồn dữ liệu của bài đánh giá sản phẩm.

MerchantReviewDataSource

Loại này không có trường nào.

Nguồn dữ liệu bài đánh giá người bán.

Đầu vào

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

Enum
INPUT_UNSPECIFIED Không xác định dữ liệu đầu vào.
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 chủ yếu được cung cấp thông qua phương thức nhập tệp. Bạn vẫn có thể cung cấp dữ liệu thông qua API.
UI

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

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

Loại nguồn dữ liệu này chỉ có thể đọc.
AUTOFEED Đây còn được 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 dành riêng cho nguồn dữ liệu tệp. Trường này sẽ trống đối với các 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 để phân phối nguồn dữ liệu. Tệp này chứa các chế độ cài đặt cho loại dữ liệu đầu vào tệp FETCH và GOOGLE_SHEETS. Các trường bắt buộc sẽ 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 dữ liệu đầu vào tệp UPLOAD.
fileInputType

enum (FileInputType)

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

FetchSettings

Tìm nạp thông tin chi tiết để phân phối 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 biểu 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 sẽ đượ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 sẽ được tìm nạp. Không hỗ trợ phút và giây, các giá trị này 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 sẽ đượ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. Theo múi giờ 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 nơi có thể tìm nạp tệp nguồn dữ liệu. Google Merchant Center hỗ trợ tính năng tải lên tự động theo lịch bằng các giao thức HTTP, HTTPS hoặc SFTP, vì vậy, giá trị này cần phải là một đường liên kết hợp lệ sử dụng một trong ba giao thức đó. Không thể thay đổi đối với 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 fetchUri. 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 fetchUri. Dùng để gửi nguồn dữ liệu thông qua SFTP.

TimeOfDay

Biểu thị 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 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

Số giờ trong ngày theo định dạng 24 giờ. Phải lớn hơn hoặc bằng 0 và thường phải nhỏ hơn hoặc bằng 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 một giờ. Phải lớn hơn hoặc bằng 0 và nhỏ hơn hoặc bằng 59.
seconds

integer

Số giây trong một phút. Phải lớn hơn hoặc bằng 0 và thường phải nhỏ hơn hoặc bằng 59. API có thể cho phép giá trị 60 nếu cho phép giây nhuận.
nanos

integer

Phân số giây, tính bằng nano giây. Phải lớn hơn hoặc bằng 0 và nhỏ hơn hoặc bằng 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 Tuesday (thứ Ba)
WEDNESDAY Wednesday (thứ Tư)
THURSDAY Thursday (thứ Năm)
FRIDAY Friday (thứ Sáu)
SATURDAY Saturday (thứ Bảy)
SUNDAY Chủ Nhật

Tần suất

Các trường bắt buộc sẽ 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 có [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 có [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 [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 chỉ định loại dữ liệu đầu vào tệ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 được tìm nạp từ fetchUri đã định cấu hình.
GOOGLE_SHEETS Tệp được tìm nạp từ Google Trang tính được chỉ định trong fetchUri.

Phương thức

create

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

delete

 Xoá một 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 (ngay cả ngoài lịch tìm nạp) trên một nguồn dữ liệu trong tài khoản Merchant Center.

get

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

list

 Liệt kê cấu hình cho nguồn dữ liệu của tài khoản đã cho.

patch

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