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 nguồn dữ liệu theo phương thức lập trình để bạn có thể 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. 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 sẽ đượ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 bạn quản lý các nguồn dữ liệu có phương thức nhập tệp. Merchant API cho phép bạn quản lý nguồn dữ liệu bằng cả dữ liệu đầu vào dạng tệp và 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 một nguồn dữ liệu không đặt các trường feedLabel và contentLanguage. 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 mình, vì bạn có thể chèn các sản phẩm có nhiều tổ hợp feedLabel và contentLanguage vào một nguồn dữ liệu.
Tạo một 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 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ề kênh nguồn dữ liệu, hãy xem phần Kênh.

Điều kiện tiên quyết

Tài khoản của bạn phải được di chuyển sang nguồn cấp dữ liệu theo ngôn ngữ.
Để xác minh rằng tài khoản đã được di chuyển sang tính năng 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 các phương thức lấy. 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 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 các yêu cầu về dữ liệu và tiêu chí của Merchant Center, bạn sẽ không cần phải tạo thêm bất kỳ nguồn dữ liệu nào.

Để tạo một nguồn dữ liệu chính mới có 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 loại. Để biết thêm thông tin về các trường này, hãy xem PrimaryProductDataSource.

Yêu cầu mẫu sau đây minh hoạ cách bạn có thể tạo nguồn dữ liệu sản phẩm chính:

POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{ACCOUNT_ID}/dataSources

{
  "displayName": "{DISPLAY_NAME}",
  "primaryProductDataSource": {
    "contentLanguage": "{CONTENT_LANGUAGE}",
    "feedLabel": "{FEED_LABEL}",
    "countries": [
      "{COUNTRY}"
    ],
    "channel": "ONLINE_PRODUCTS"
  }
}

Thay thế nội dung sau:

{ACCOUNT_ID}: Giá trị nhận dạng duy nhất của tài khoản Merchant Center.
{DISPLAY_NAME}: Tên hiển thị của nguồn dữ liệu.
{CONTENT_LANGUAGE}: Mã ngôn ngữ ISO 639-1 gồm hai chữ cái của các sản phẩm trong nguồn dữ liệu.
{FEED_LABEL}: Nhãn nguồn cấp dữ liệu của nguồn dữ liệu.
{COUNTRY}: Mã lãnh thổ CLDR của quốc gia mục tiêu của các sản phẩm sẽ được tải lên bằng nguồn dữ liệu.

Sau khi chạy thành công yêu cầu, bạn sẽ thấy phản hồi sau:

{
  "name": "accounts/{ACCOUNT_ID}/dataSources/{DATA_SOURCE_ID}",
  "dataSourceId": "{DATA_SOURCE_ID}",
  "displayName": "{DISPLAY_NAME}",
  "primaryProductDataSource": {
    "channel": "ONLINE_PRODUCTS",
    "feedLabel": "{FEED_LABEL}",
    "contentLanguage": "{CONTENT_LANGUAGE}",
    "countries": [
      "{COUNTRY}"
    ],
    "defaultRule": {
      "takeFromDataSources": [
        {
          "self": true
        }
      ]
    }
  },
  "input": "API"
}

Để biết thêm thông tin về cách tạo nguồn dữ liệu, hãy xem phương thức 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 sử dụng Content API for Shopping, hệ thống sẽ chỉ tạo một nguồn dữ liệu API 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, trong đó một số nguồn dữ liệu có thể không đặt trường feedLabel và contentLanguage.

Chỉ những nguồn dữ liệu có dữ liệu đầu vào API mới có thể không đặt trường feedLabel và contentLanguage. 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 nguồn dữ liệu bổ sung, trong đó mỗi nguồn dữ liệu bổ sung có thể bổ sung dữ liệu cho số lượng nguồn dữ liệu chính bất kỳ.

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 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 phương thức 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.

Lấy 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.

Danh sách nguồn dữ liệu

Để liệt kê các 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 phương thức 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ý 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ả thuộc tính 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 trường quy tắc mặc định.

Để biết thêm thông tin về cách thiết lập quy tắc, hãy xem bài viết Thiết lập quy tắc cho nguồn dữ liệu sản phẩm.

Cấu hình mẫu sau đây đảm bảo rằng tất cả các thuộc tính được lấy từ nguồn dữ liệu có giá trị nhận dạng duy nhất 1001. Sau đó, các thuộc tính còn thiếu 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 cùng một thuộc tính được cung cấp trong nhiều nguồn dữ liệu, thì giá trị cao hơn trong danh sách sẽ được 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ý nguồn dữ liệu, bạn phải làm như 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 phương thức accounts.autofeedSettings.getAutofeedSettings.
Đảm bảo rằng tài khoản của bạn không phải là tài khoản trang web thương mại.

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 dịch vụ 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/{ACCOUNT_ID}/datasources/{DATASOURCE_ID}/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 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 bao giờ đượ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.