Trang này cho biết cách tạo và cập nhật các nguồn dữ liệu theo phương thức lập trình để cho phép bạn chèn sản phẩm. Nguồn dữ liệu tự động giúp bạn dễ dàng gửi dữ liệu sản phẩm đến Google. Các nguồn dữ liệu tự động đảm bảo rằng thông tin mới nhất về các sản phẩm có liên quan trên trang web của bạn được gửi đến Google.
Content API for Shopping chỉ cho phép bạn tạo nguồn dữ liệu chính. Với API Nguồn dữ liệu người bán, bạn có thể tạo các loại nguồn dữ liệu sau:
- Nguồn dữ liệu sản phẩm chính
- Nguồn dữ liệu sản phẩm bổ sung
- Nguồn dữ liệu kho hàng tại địa phương
- Nguồn dữ liệu kho hàng theo khu vực
- Nguồn dữ liệu về chương trình khuyến mãi
Content API for Shopping chỉ cho phép quản lý nguồn dữ liệu có dữ liệu đầu vào. Merchant API giúp bạn quản lý các nguồn dữ liệu bằng cả tệp và dữ liệu đầu vào API.
Khi sử dụng API Nguồn dữ liệu người bán, bạn có thể làm những việc sau:
- Tạo nguồn dữ liệu chính mới có
feedLabel
vàcontentLanguage
cụ thể. - Tạo một nguồn dữ liệu ký tự đại diện. Một nguồn dữ liệu ký tự đại diện chưa đặt trường
feedLabel
vàcontentLanguage
. Các nguồn dữ liệu ký tự đại diện cho phép bạn chèn sản phẩm có nhiều kiểu kết hợpfeedLabel
vàcontentLanguage
vào một nguồn dữ liệu. - Tạo nguồn dữ liệu bổ sung để liên kết với một nguồn dữ liệu chính hiện có.
- Thiết lập lịch biểu cho nguồn dữ liệu của tệp.
- Quản lý nguồn dữ liệu API.
- Sử dụng các loại nguồn dữ liệu khác như chương trình khuyến mãi.
Điều kiện tiên quyết
- Tài khoản của bạn phải được chuyển sang nguồn cấp dữ liệu ngôn ngữ duy nhất.
Để xác minh rằng tài khoản đã được di chuyển sang phần phân tách mục tiêu dữ liệu, hãy sử dụng danh sách nguồn dữ liệu hoặc phương thức nhận. Trong trường hợp không đủ điều kiện, bạn sẽ nhận được thông báo về trường hợp ngoại lệ sau đây và bạn nên liên hệ với bộ phận hỗ trợ.
This account is in the data sources migration process and can't be used with this API yet. Contact support for more info on when this account will be able to use the data sources endpoint.
Tạo nguồn dữ liệu mới
Để tạo nguồn dữ liệu chính mới bằng feedLabel
và contentLanguage
cụ thể, hãy đặt các trường feedLabel
và contentLanguage
trong cấu hình dành riêng cho từng loại. Ví dụ: PrimaryProductDataSource
Để xem nguồn dữ liệu mới tạo, hãy tạo một yêu cầu GET
hoặc LIST
.
Tạo nguồn dữ liệu chính bằng ký tự đại diện mới
Để tạo một nguồn cấp dữ liệu chính mới ký tự đại diện, hãy định cấu hình nguồn dữ liệu bằng cách sử dụng PrimaryProductDataSource
và không đặt trường feedLabel
và contentLanguage
.
Khi sử dụng Content API for Shopping, chỉ có một nguồn dữ liệu API được tạo cho bạn. Khi sử dụng API Nguồn dữ liệu người bán, bạn có thể có nhiều nguồn dữ liệu API, một số nguồn có thể là ký tự đại diện.
Chỉ những nguồn dữ liệu có đầu vào API mới có thể là nguồn dữ liệu ký tự đại diện. Các nguồn dữ liệu ký tự đại diện không được hỗ trợ cho hoạt động đầu vào tệp.
Tạo nguồn dữ liệu bổ sung rồi liên kết nguồn dữ liệu đó với nguồn dữ liệu chính
Bạn có thể sử dụng các nguồn dữ liệu bổ sung để cập nhật một phần dữ liệu sản phẩm bằng cách thêm giá trị nhận dạng duy nhất của nguồn dữ liệu làm tham số truy vấn khi thực hiện lệnh gọi đến phương thức accounts.productInputs.insert
và accounts.productInputs.delete
. Bạn chỉ có thể sử dụng các nguồn dữ liệu bổ sung để cập nhật các sản phẩm hiện có.
Để tạo nguồn dữ liệu bổ sung, hãy định cấu hình nguồn dữ liệu bằng cách sử dụng SupplementalProductDataSource
, sau đó liên kết nguồn dữ liệu đó bằng cách cập nhật trường defaultRule
trên nguồn dữ liệu chính.
Nguồn dữ liệu tệp bổ sung không được là nguồn dữ liệu ký tự đại diện. Nguồn dữ liệu bổ sung cho API phải luôn là nguồn dữ liệu ký tự đại diện.
Thiết lập lịch biểu cho nguồn dữ liệu tệp
Để thiết lập lịch cho nguồn cấp dữ liệu tệp, hãy định cấu hình nguồn dữ liệu của bạn thành nguồn dữ liệu tệp bằng cách sử dụng trường FileInput
, sau đó thiết lập fetchsettings
bằng trường FileInput.FetchSettings
.
Xoá nguồn dữ liệu
Để xoá một nguồn dữ liệu hiện có khỏi tài khoản của bạn, hãy sử dụng phương thức accounts.dataSources.delete
.
Tìm nạp nguồn dữ liệu
Để tìm nạp một tệp được định cấu hình trong nguồn dữ liệu, hãy sử dụng phương thức
accounts.dataSources.fetch
. Phương thức này thực hiện việc tìm nạp dữ liệu ngay lập tức trên nguồn dữ liệu từ tài khoản của bạn. 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.
Tải nguồn dữ liệu
Để truy xuất cấu hình nguồn dữ liệu cho tài khoản của bạn, hãy sử dụng phương thức
accounts.dataSources.get
.
Liệt kê nguồn dữ liệu
Để liệt kê cấu hình của các nguồn dữ liệu cho tài khoản, hãy sử dụng phương thức
accounts.dataSources.list
.
Bản vá nguồn dữ liệu
Để cập nhật cấu hình của một nguồn dữ liệu hiện có, hãy sử dụng phương thức
accounts.dataSources.patch
.