- Tài nguyên: DataSource
- PrimaryProductDataSource
- Kênh
- SupplementalProductDataSource
- LocalInventoryDataSource
- RegionalInventoryDataSource
- PromotionDataSource
- Input
- FileInput
- FetchSettings
- TimeOfDay
- DayOfWeek
- Tần suất
- FileInputType
- Phương thức
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 ( |
Trường | |
---|---|
name |
Giá trị nhận dạng. Tên của nguồn dữ liệu. Định dạng |
dataSourceId |
Chỉ có đầu ra. Mã nguồn dữ liệu. |
displayName |
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 |
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 |
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 |
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 |
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 |
Bắt buộc. Nguồn dữ liệu kho hàng tại địa phương. |
regionalInventoryDataSource |
Bắt buộc. Nguồn dữ liệu kho hàng theo khu vực. |
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 ( |
Trường | |
---|---|
channel |
Bắt buộc. Bất biến. Chỉ định loại kênh nguồn dữ liệu. |
countries[] |
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 |
Không bắt buộc. Bất biến. 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ả 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 |
Không bắt buộc. Bất biến. 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ả 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. |
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 |
Không bắt buộc. Bất biến. 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ả 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 |
Không bắt buộc. Bất biến. 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ả 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 |
Bắt buộc. Bất biến. 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 |
Bắt buộc. Bất biến. 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 |
Bắt buộc. Bất biến. 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 |
Bắt buộc. Bất biến. 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 |
Bắt buộc. Bất biến. 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 |
Bắt buộc. Bất biến. 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 ( |
Trường | |
---|---|
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 |
fileName |
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 |
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 ( |
Trường | |
---|---|
enabled |
Không bắt buộc. Bật hoặc tạm dừng lịch tìm nạp. |
dayOfMonth |
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. |
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 |
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 |
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 |
Bắt buộc. Tần suất mô tả lịch tìm nạp. |
fetchUri |
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 |
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 |
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 |
Giờ trong ngày ở định dạng 24 giờ. Nên ở từ 0 đến 23. Một 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 |
Số phút trong ngày. Phải từ 0 đến 59. |
seconds |
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 |
Các phân số của 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 |
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 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ừ [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 |
|
---|---|
|
Tạo cấu hình nguồn dữ liệu mới cho tài khoản cụ thể. |
|
Xoá nguồn dữ liệu khỏi tài khoản Merchant Center. |
|
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. |
|
Truy xuất cấu hình nguồn dữ liệu cho tài khoản cụ thể. |
|
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ể. |
|
Cập nhật cấu hình nguồn dữ liệu hiện có. |