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. Dữ liệu tự động nguồn giúp bạn gửi dễ dàng hơn dữ liệu sản phẩm của bạn cho Google. Các nguồn dữ liệu tự động đảm bảo rằng các thông tin mới nhất về các sản phẩm có liên quan từ trang web của bạn tiếp cận Google.

Content API for Shopping chỉ cho phép bạn tạo nguồn dữ liệu chính. Bằng Merchant Data Source API, bạn có thể tạo các loại nguồn dữ liệu sau đây:

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 cụ thể và contentLanguage
  • Tạo một nguồn dữ liệu ký tự đại diện. Nguồn dữ liệu ký tự đại diện không có feedLabel và contentLanguage đã được đặt. Các nguồn dữ liệu ký tự đại diện cho phép bạn chèn các sản phẩm có các cách kết hợp khác nhau của 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 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 ngoại lệ sau đây. 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

Cách tạo nguồn dữ liệu chính mới có feedLabel và contentLanguage, đặt các trường feedLabel và contentLanguage trong cấu hình cụ thể theo 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 nguồn cấp dữ liệu chính mới bằng ký tự đại diện, hãy thiết lập nguồn dữ liệu bằng cách sử dụng PrimaryProductDataSource và không đặt trường feedLabel và contentLanguage.

Khi bạn 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ố ký tự trong số đó 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. Dữ liệu ký tự đại diện nguồn không được hỗ trợ cho đầ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 dưới dạng tham số truy vấn khi thực hiện lệnh gọi đến 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 thiết lập nguồn dữ liệu bằng cách sử dụng SupplementalProductDataSource, sau đó liên kết tài khoản đó bằng cách cập nhật defaultRule trên nguồn dữ liệu chính của bạn.

Nguồn dữ liệu tệp bổ sung không được là nguồn dữ liệu ký tự đại diện. API bổ sung nguồn dữ liệu 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 thành một tệp nguồn dữ liệu bằng cách sử dụng trường FileInput, rồi thiết lập fetchsettings bằng cách sử dụng trường FileInput.FetchSettings.

Xoá nguồn dữ liệu

Để xoá nguồn dữ liệu hiện có khỏi tài khoản của bạn, hãy sử dụng 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 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 accounts.dataSources.get .

Liệt kê nguồn dữ liệu

Để liệt kê cấu hình cho các nguồn dữ liệu cho tài khoản của bạn, hãy sử dụng 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 accounts.dataSources.patch .