Tổng quan về API Nguồn dữ liệu của người bán

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:

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ợp feedLabel 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.