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 gửi dữ liệu sản phẩm đến Google dễ dàng hơn. 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. 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 bạn quản lý các nguồn dữ liệu có phương thức nhập tệp. 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 một nguồn dữ liệu chính mới bằng một feedLabel và contentLanguage cụ thể.
  • Tạo nguồn dữ liệu không có feedLabel và contentLanguage đã đặt. Khi sử dụng loại nguồn dữ liệu này, bạn có thể nhắm đến nhiều quốc gia cho sản phẩm của bạn, vì bạn có thể 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 duy nhất.
  • 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 tệp.
  • Đăng ký tài khoản của bạn để tự động quản lý các 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.

Bạn không thể sử dụng Merchant API để chèn sản phẩm vào một nguồn dữ liệu chứa cả sản phẩm tại cửa hàng địa phương và sản phẩm trực tuyến. Để biết thêm thông tin về nguồn dữ liệu kênh, xem Kênh.

Đ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 và nên liên hệ với nhóm 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

Nguồn dữ liệu chính là nguồn dữ liệu chính cho kho hàng của bạn trên Merchant Center. Bạn chỉ có thể thêm hoặc xoá sản phẩm bằng cách sử dụng nguồn dữ liệu chính. Nếu mỗi sản phẩm bạn thêm vào nguồn dữ liệu chính đều đáp ứng dữ liệu của Merchant Center và đáp ứng đủ điều kiện, bạn sẽ không cần phải tạo thêm bất kỳ nguồn dữ liệu nào.

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. Để biết thêm thông tin về các trường này, hãy xem PrimaryProductDataSource.

Để biết thêm thông tin về cách tạo nguồn dữ liệu, hãy xem accounts.dataSources.create .

Để xem nguồn dữ liệu mới tạo, hãy sử dụng phương thức accounts.dataSources.get hoặc accounts.dataSources.list.

Tạo một nguồn dữ liệu chính mới giúp nhắm đến nhiều quốc gia

Để tạo một nguồn cấp dữ liệu chính mới giúp bạn nhắm đến nhiều quốc gia, hãy định cấu hình nguồn dữ liệu bằng PrimaryProductDataSource và không đặt các 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ố trong số đó có thể không có trường feedLabel và contentLanguage.

Chỉ những nguồn dữ liệu có đầu vào API mới có thể không có feedLabel và Đã đặt contentLanguage trường. Loại nguồn dữ liệu này không được hỗ trợ cho dữ liệu đầu vào tệp.

Tạo nguồn dữ liệu bổ sung và liên kết nguồn dữ liệu đó với nguồn dữ liệu chính

Nguồn dữ liệu bổ sung chỉ dùng để cập nhật dữ liệu sản phẩm đã có trong một hoặc nhiều nguồn dữ liệu chính. Bạn có thể có nhiều phần bổ sung nguồn dữ liệu và mỗi nguồn dữ liệu đều có thể bổ sung dữ liệu với số lượng dữ liệu chính bất kỳ nguồn.

Bạn có thể sử dụng 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 các phương thức accounts.productInputs.insert và accounts.productInputs.delete. Bạn chỉ có thể sử dụng 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 phải đặt các trường feedLabel và contentLanguage. Nguồn dữ liệu API bổ sung phải luôn đặt trường feedLabel và contentLanguage thành không xác định.

Thiết lập lịch biểu cho nguồn dữ liệu tệp

Để thiết lập lịch biểu 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 cách sử dụ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, 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 accounts.dataSources.fetch . Phương thức này thực hiện tìm nạp dữ liệu ngay lập tức trên một 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 đầu vào 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 cho nguồn dữ liệu của tài khoản, hãy sử dụng phương thức accounts.dataSources.list.

Nguồn dữ liệu bản vá

Để 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 .

Nguồn dữ liệu sản phẩm chính cho phép bạn quản lý quy tắc mặc định 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 bạn. 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ả các thuộc tính đều được lấy 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 thuộc tính còn lại sẽ được lấy từ nguồn dữ liệu bổ sung có giá trị nhận dạng duy nhất 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ý tài khoản của mình để tự động quản lý các nguồn dữ liệu, bạn phải làm như sau:

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.updateAutofeedSettings để bật tính năng tự động quản lý nguồn dữ liệu. Khi bạn bật tính năng tự động quản lý nguồn dữ liệu, Google sẽ tự động thêm sản phẩm từ cửa hàng trực tuyến của bạ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 accounts.dataSources.fileUploads . Để lấy kết quả truy xuất gần đây nhất của nguồn dữ liệu được tính toán không đồng bộ khi quá trình xử lý nguồn dữ liệu kết thúc, 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ề các sản phẩm của bạn, bao gồm cả mọi vấn đề tiềm ẩn.

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 đang xử lý nếu bạn yêu cầu ngay sau khi tải tệp lên.