Package google.shopping.merchant.datasources.v1beta

Chỉ mục

DataSourcesService

Dịch vụ giúp quản lý các nguồn dữ liệu chính, bổ sung, kho hàng và các nguồn dữ liệu khác. Xem thêm thông tin trong bài viết trợ giúp về Merchant Center.

CreateDataSource

rpc CreateDataSource(CreateDataSourceRequest) returns (DataSource)

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

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/content

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.
DeleteDataSource

rpc DeleteDataSource(DeleteDataSourceRequest) returns (Empty)

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

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/content

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.
FetchDataSource

rpc FetchDataSource(FetchDataSourceRequest) returns (Empty)

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. Nếu cần gọi phương thức này nhiều lần mỗi ngày, bạn nên sử dụng dịch vụ Sản phẩm để cập nhật dữ liệu sản phẩm của mình. Phương thức này chỉ hoạt động trên các nguồn dữ liệu có tập hợp thông tin đầu vào là tệp.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/content

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.
GetDataSource

rpc GetDataSource(GetDataSourceRequest) returns (DataSource)

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

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/content

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.
ListDataSources

rpc ListDataSources(ListDataSourcesRequest) returns (ListDataSourcesResponse)

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ể.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/content

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.
UpdateDataSource

rpc UpdateDataSource(UpdateDataSourceRequest) returns (DataSource)

Cập nhật cấu hình nguồn dữ liệu hiện có. Những trường được đặt trong mặt nạ cập nhật nhưng không được cung cấp trong tài nguyên sẽ bị xoá.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/content

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.

CreateDataSourceRequest

Yêu cầu thông báo cho phương thức CreateDataSource.

Trường
parent

string

Bắt buộc. Tài khoản mà nguồn dữ liệu này sẽ được tạo. Định dạng accounts/{account}
data_source

DataSource

Bắt buộc. Nguồn dữ liệu để tạo.

DataSource

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

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}}
data_source_id

int64

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

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

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.
file_input

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:
primary_product_data_source

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à bán trực tuyến.
supplemental_product_data_source

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.
local_inventory_data_source

LocalInventoryDataSource

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

RegionalInventoryDataSource

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

PromotionDataSource

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

Đầ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.

DeleteDataSourceRequest

Yêu cầu thông báo cho phương thức DeleteDataSource.

Trường
name

string

Bắt buộc. Tên của nguồn dữ liệu cần xoá. Định dạng accounts/{account}/dataSources/{datasource}

FetchDataSourceRequest

Thông báo yêu cầu cho phương thức FetchDataSource.

Trường
name

string

Bắt buộc. Tên của tài nguyên nguồn dữ liệu cần tìm nạp. Định dạng accounts/{account}/dataSources/{datasource}

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.

Trường
fetch_settings

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.
file_name

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.
file_input_type

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.

Trường
enabled

bool

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

int32

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 theo tháng.
time_of_day

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. Tính năng phút và giây không được hỗ trợ và sẽ bị bỏ qua.
day_of_week

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.
time_zone

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

Frequency

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

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.

Tần suất

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 cầ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ừ [fetch_uri][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 [fetch_uri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri].

GetDataSourceRequest

Yêu cầu thông báo cho phương thức GetDataSource.

Trường
name

string

Bắt buộc. Tên của nguồn dữ liệu cần truy xuất. Định dạng accounts/{account}/dataSources/{datasource}

ListDataSourcesRequest

Yêu cầu thông báo cho phương thức ListDataSources.

Trường
parent

string

Bắt buộc. Tài khoản để liệt kê nguồn dữ liệu. Định dạng accounts/{account}
page_size

int32

Không bắt buộc. Số lượng nguồn dữ liệu tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Giá trị tối đa là 1000; các giá trị lớn hơn 1000 sẽ bị buộc thành 1000. Nếu bạn không chỉ định, hàm sẽ trả về số lượng nguồn dữ liệu tối đa.
page_token

string

Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi ListDataSources trước đó. Cung cấp mã này để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham số khác được cung cấp cho ListDataSources phải khớp với lệnh gọi đã cung cấp mã thông báo trang.

ListDataSourcesResponse

Thông báo phản hồi cho phương thức ListDataSources.

Trường
data_sources[]

DataSource

Các nguồn dữ liệu từ tài khoản được chỉ định.
next_page_token

string

Mã thông báo có thể được gửi dưới dạng page_token để truy xuất trang tiếp theo. Nếu trường này bị bỏ qua thì sẽ không có trang tiếp theo.

LocalInventoryDataSource

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

Trường
feed_label

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.
content_language

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.

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.

Trường
channel

Channel

Bắt buộc. Bất biến. 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.
feed_label

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 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 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ế đó.
content_language

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

PromotionDataSource

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

Trường
target_country

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.
content_language

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.

RegionalInventoryDataSource

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

Trường
feed_label

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.
content_language

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.

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.

Trường
feed_label

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.
content_language

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.

UpdateDataSourceRequest

Yêu cầu thông báo cho phương thức UpdateDataSource.

Trường
data_source

DataSource

Bắt buộc. Tài nguyên nguồn dữ liệu cần cập nhật.
update_mask

FieldMask

Bắt buộc. Danh sách các trường về nguồn dữ liệu sẽ được cập nhật.

Các trường được chỉ định trong mặt nạ cập nhật mà không có giá trị được chỉ định trong phần nội dung sẽ bị xoá khỏi nguồn dữ liệu.

Cung cấp "*" đặc biệt để thay thế nguồn dữ liệu đầy đủ không được hỗ trợ.