Trang này được dịch bởi Cloud Translation API.

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ý 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.
Đăng ký cho tài khoản của bạn để sử dụng tính năng tự động quản lý nguồn dữ liệu.
Quản lý nguồn dữ liệu API.
Quản lý quy tắc mặc định của nguồn dữ liệu bằng cách sử dụng nguồn dữ liệu sản phẩm chính.
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 .

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

Nguồn dữ liệu sản phẩm chính cho phép bạn quản lý chế độ mặc định quy tắc của nguồn dữ liệu. Quy tắc mặc định là quy tắc áp dụng cho tất cả trong nguồn dữ liệu của mình. Bạn có thể đặt quy tắc mặc định trong khi tạo nguồn dữ liệu hoặc bằng cách cập nhật nguồn dữ liệu hiện có thông qua quy tắc mặc định .

Cấu hình mẫu sau đây đảm bảo rằng tất cả thuộc tính sẽ được lấy trước từ nguồn dữ liệu có giá trị nhận dạng duy nhất 1001. Tiếp đến là sẽ được thêm từ nguồn dữ liệu chính. Cuối cùng, các mục tiêu còn lại sẽ được lấy từ nguồn dữ liệu bổ sung có chứa giá trị nhận dạng 1002 nếu chưa được cung cấp trong bất kỳ nguồn dữ liệu nào khác. Nếu giống nhau được cung cấp trong nhiều nguồn dữ liệu, thì giá trị càng cao trong danh sách đã chọn.

defaultRule {
 takeFromDataSources: [
   '1001', // Supplemental product data source
   'self', //  Self reference to the primary data source
   '1002' // Supplemental product data source
 ]
}

Tự động quản lý nguồn cấp dữ liệu

Để đăng ký cho tài khoản của bạn sử dụng tính năng tự động quản lý các nguồn dữ liệu, bạn phải sau:

Kiểm tra xem tài khoản của bạn có đủ điều kiện đăng ký hay không bằng cách gọi Accounts.AutofeedSettings.Get.
Đảm bảo rằng tài khoản của bạn không phải là trang web thương mại tài khoản.

Sau khi tài khoản của bạn đủ điều kiện đăng ký, bạn có thể sử dụng Phương thức Accounts.AutofeedSettings.Update để bật tính năng tự động quản lý dữ liệu nguồn. Việc bật tính năng tự động quản lý nguồn dữ liệu cho phép Google tự động thêm sản phẩm từ cửa hàng trực tuyến và đảm bảo sản phẩm luôn được cập nhật trên các nền tảng của Google.

Truy xuất trạng thái tải tệp lên

Để biết trạng thái của nguồn dữ liệu bằng tệp, tìm nạp hoặc bảng tính, bạn có thể gọi phương thức GET của dịch vụ FileUpload. Để nhận được kết quả của lần truy xuất nguồn dữ liệu cuối cùng được tính toán không đồng bộ khi dữ liệu quá trình xử lý nguồn đã hoàn tất, hãy sử dụng giá trị nhận dạng tên latest.

GET https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/datasources/{datasourceId}/fileUploads/latest

Trạng thái tải tệp lên có thể chứa thông tin chi tiết về sản phẩm, bao gồm bất kỳ vấn đề tiềm ẩn nào.

Xin lưu ý rằng trạng thái tải tệp lên có thể không tồn tại nếu tệp chưa từng được tải lên. Trạng thái tải tệp lên có thể ở trạng thái xử lý nếu được yêu cầu ngay sau đó tệp đã được tải lên.