Chỉ mục
DataSourcesService
(giao diện)FileUploadsService
(giao diện)CreateDataSourceRequest
(thông báo)DataSource
(thông báo)DataSource.Input
(enum)DataSourceReference
(thông báo)DeleteDataSourceRequest
(thông báo)FetchDataSourceRequest
(thông báo)FileInput
(thông báo)FileInput.FetchSettings
(thông báo)FileInput.FetchSettings.Frequency
(enum)FileInput.FileInputType
(enum)FileUpload
(thông báo)FileUpload.Issue
(thông báo)FileUpload.Issue.Severity
(enum)FileUpload.ProcessingState
(enum)GetDataSourceRequest
(thông báo)GetFileUploadRequest
(thông báo)ListDataSourcesRequest
(thông báo)ListDataSourcesResponse
(thông báo)LocalInventoryDataSource
(thông báo)MerchantReviewDataSource
(thông báo)PrimaryProductDataSource
(thông báo)PrimaryProductDataSource.Channel
(enum)PrimaryProductDataSource.DefaultRule
(thông báo)ProductReviewDataSource
(thông báo)PromotionDataSource
(thông báo)RegionalInventoryDataSource
(thông báo)SupplementalProductDataSource
(thông báo)UpdateDataSourceRequest
(thông báo)
DataSourcesService
Dịch vụ quản lý 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 trong bài viết trợ giúp về Merchant Center.
CreateDataSource |
---|
Tạo cấu hình nguồn dữ liệu mới cho tài khoản đã cho.
|
DeleteDataSource |
---|
Xoá một nguồn dữ liệu khỏi tài khoản Merchant Center.
|
FetchDataSource |
---|
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. 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. Phương thức này chỉ hoạt động trên các nguồn dữ liệu có tập hợp đầu vào tệp.
|
GetDataSource |
---|
Truy xuất cấu hình nguồn dữ liệu cho tài khoản đã cho.
|
ListDataSources |
---|
Liệt kê cấu hình cho nguồn dữ liệu của tài khoản đã cho.
|
UpdateDataSource |
---|
Cập nhật cấu hình nguồn dữ liệu hiện có. Các 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á.
|
FileUploadsService
Dịch vụ quản lý việc tải tệp nguồn dữ liệu lên.
GetFileUpload |
---|
Tải tệp nguồn dữ liệu mới nhất lên. Chỉ chấp nhận bí danh
|
CreateDataSourceRequest
Thông báo yêu cầu cho phương thức CreateDataSource.
Trường | |
---|---|
parent |
Bắt buộc. Tài khoản nơi nguồn dữ liệu này sẽ được tạo. Định dạng |
data_ |
Bắt buộc. Nguồn dữ liệu cần tạo. |
DataSource
Nguồn dữ liệu cho tài khoản Merchant Center.
Trường | |
---|---|
name |
Giá trị nhận dạng. Tên của nguồn dữ liệu. Định dạng |
data_ |
Chỉ có đầu ra. Mã nguồn dữ liệu. |
display_ |
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 |
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. |
file_ |
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 . Bắt buộc. Loại nguồn dữ liệu. Type chỉ có thể là một trong những giá trị sau: |
|
primary_ |
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ên mạng. |
supplemental_ |
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. |
local_ |
Nguồn dữ liệu kho hàng tại địa phương. |
regional_ |
Nguồn dữ liệu kho hàng theo khu vực. |
promotion_ |
Nguồn dữ liệu khuyến mãi. |
product_ |
Nguồn dữ liệu bài đánh giá sản phẩm. |
merchant_ |
Nguồn dữ liệu bài đánh giá của 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. |
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.
Trường | |
---|---|
Trường hợp hợp nhất
|
|
self |
Bạn nên sử dụng Self để tham chiếu chính nguồn dữ liệu chính. |
primary_ |
Không bắt buộc. Tên của nguồn dữ liệu chính. Định dạng |
supplemental_ |
Không bắt buộc. Tên của nguồn dữ liệu bổ sung. Định dạng |
DeleteDataSourceRequest
Thông báo yêu cầu cho phương thức DeleteDataSource.
Trường | |
---|---|
name |
Bắt buộc. Tên của nguồn dữ liệu cần xoá. Định dạng |
FetchDataSourceRequest
Thông báo yêu cầu cho phương thức FetchDataSource.
Trường | |
---|---|
name |
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 |
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.
Trường | |
---|---|
fetch_ |
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 |
file_ |
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 |
file_ |
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.
Trường | |
---|---|
enabled |
Không bắt buộc. Bật hoặc tạm dừng lịch biểu tìm nạp. |
day_ |
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. |
time_ |
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. |
day_ |
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. |
time_ |
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 |
Bắt buộc. Tần suất mô tả lịch tìm nạp. |
fetch_ |
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 |
Không bắt buộc. Tên người dùng không bắt buộc cho |
password |
Không bắt buộc. Mật khẩu không bắt buộc cho |
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 |
Tần suất không được chỉ định. |
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ừ fetch_uri đã định cấu hình. |
GOOGLE_SHEETS |
Tệp được tìm nạp từ Google Trang tính được chỉ định trong fetch_uri . |
FileUpload
Quá trình tải tệp lên một nguồn dữ liệu cụ thể, tức là kết quả truy xuất nguồn dữ liệu tại một dấu thời gian nhất định được tính không đồng bộ khi quá trình xử lý nguồn dữ liệu kết thúc. Chỉ áp dụng cho nguồn dữ liệu tệp.
Trường | |
---|---|
name |
Giá trị nhận dạng. Tên của tệp nguồn dữ liệu được tải lên. Định dạng |
data_ |
Chỉ có đầu ra. Mã nguồn dữ liệu. |
processing_ |
Chỉ có đầu ra. Trạng thái xử lý của nguồn dữ liệu. |
issues[] |
Chỉ có đầu ra. Danh sách các vấn đề xảy ra trong nguồn dữ liệu. |
items_ |
Chỉ có đầu ra. Số lượng mục trong nguồn dữ liệu đã được xử lý. |
items_ |
Chỉ có đầu ra. Số lượng mục trong nguồn dữ liệu đã được tạo. |
items_ |
Chỉ có đầu ra. Số lượng mục trong nguồn dữ liệu đã được cập nhật. |
upload_ |
Chỉ có đầu ra. Ngày tải tệp nguồn dữ liệu lên. |
Vấn đề
Lỗi xảy ra trong nguồn dữ liệu, chẳng hạn như "giá không hợp lệ".
Trường | |
---|---|
title |
Chỉ có đầu ra. Tiêu đề của vấn đề, ví dụ: "Mặt hàng quá lớn". |
description |
Chỉ có đầu ra. Nội dung mô tả lỗi, ví dụ: "Nguồn dữ liệu của bạn chứa các mặt hàng có quá nhiều thuộc tính hoặc có kích thước quá lớn. Các mục này sẽ bị xoá". |
code |
Chỉ có đầu ra. Mã lỗi, ví dụ: "validation/invalid_value". Trả về "?" nếu không xác định được mã. |
count |
Chỉ có đầu ra. Số lần xảy ra lỗi trong quá trình tải tệp lên. |
severity |
Chỉ có đầu ra. Mức độ nghiêm trọng của vấn đề. |
documentation_ |
Chỉ có đầu ra. Đường liên kết đến tài liệu giải thích chi tiết hơn về vấn đề (nếu có). |
Mức độ nghiêm trọng
Mức độ nghiêm trọng của vấn đề.
Enum | |
---|---|
SEVERITY_UNSPECIFIED |
Mức độ nghiêm trọng không được chỉ định. |
WARNING |
Vấn đề là cảnh báo. |
ERROR |
Vấn đề là một lỗi. |
ProcessingState
Trạng thái xử lý của nguồn dữ liệu.
Enum | |
---|---|
PROCESSING_STATE_UNSPECIFIED |
Trạng thái xử lý chưa xác định. |
FAILED |
Không thể xử lý nguồn dữ liệu hoặc tất cả các mặt hàng đều có lỗi. |
IN_PROGRESS |
Nguồn dữ liệu đang được xử lý. |
SUCCEEDED |
Nguồn dữ liệu đã được xử lý thành công, mặc dù một số mục có thể gặp lỗi. |
GetDataSourceRequest
Thông báo yêu cầu cho phương thức GetDataSource.
Trường | |
---|---|
name |
Bắt buộc. Tên của nguồn dữ liệu cần truy xuất. Định dạng |
GetFileUploadRequest
Thông báo yêu cầu cho phương thức GetFileUploadRequest.
Trường | |
---|---|
name |
Bắt buộc. Tên của tệp nguồn dữ liệu tải lên để truy xuất. Định dạng |
ListDataSourcesRequest
Thông báo yêu cầu cho phương thức ListDataSources.
Trường | |
---|---|
parent |
Bắt buộc. Tài khoản cần liệt kê nguồn dữ liệu. Định dạng |
page_ |
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ị trên 1000 sẽ được chuyển đổi thành 1000. Nếu không chỉ định, hệ thống sẽ trả về số lượng nguồn dữ liệu tối đa. |
page_ |
Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi Khi phân trang, tất cả các tham số khác được cung cấp cho |
ListDataSourcesResponse
Thông báo phản hồi cho phương thức ListDataSources.
Trường | |
---|---|
data_ |
Các nguồn dữ liệu từ tài khoản được chỉ định. |
next_ |
Mã thông báo có thể được gửi dưới dạng |
LocalInventoryDataSource
Nguồn dữ liệu kho hàng tại địa phương.
Trường | |
---|---|
feed_ |
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. |
content_ |
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. |
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.
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.
Trường | |
---|---|
channel |
Bắt buộc. Không thể thay đổi. Chỉ định loại kênh nguồn dữ liệu. |
countries[] |
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. |
default_ |
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ế. |
feed_ |
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ả 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ế đó. |
content_ |
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ả 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 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. |
DefaultRule
Quản lý quy tắc mặc định của nguồn dữ liệu.
Trường | |
---|---|
take_ |
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 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: [ |
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.
PromotionDataSource
Nguồn dữ liệu khuyến mãi.
Trường | |
---|---|
target_ |
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. |
content_ |
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. |
RegionalInventoryDataSource
Nguồn dữ liệu kho hàng theo khu vực.
Trường | |
---|---|
feed_ |
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. |
content_ |
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. |
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.
Trường | |
---|---|
referencing_ |
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 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. |
feed_ |
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ả Bạn phải đặt các giá trị này cho các nguồn dữ liệu có 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ế đó. |
content_ |
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ả 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ế đó. |
UpdateDataSourceRequest
Thông báo yêu cầu cho phương thức UpdateDataSource.
Trường | |
---|---|
data_ |
Bắt buộc. Tài nguyên nguồn dữ liệu cần cập nhật. |
update_ |
Bắt buộc. Danh sách các trường nguồn dữ liệu cần 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. Không hỗ trợ việc cung cấp giá trị "*" đặc biệt để thay thế toàn bộ nguồn dữ liệu. |