Hướng dẫn này giải thích cách di chuyển chế độ tích hợp của bạn từ các dịch vụ datafeeds và datafeedstatuses của Content API for Shopping sang API phụ Nguồn dữ liệu trong Merchant API. API phụ Nguồn dữ liệu mới giúp bạn kiểm soát trực tiếp hơn đối với các quy trình dữ liệu và đơn giản hoá việc quản lý nguồn dữ liệu.
Để biết thêm thông tin về các tính năng mới, hãy xem hướng dẫn Quản lý nguồn dữ liệu.
Những điểm khác biệt chính
So với Content API for Shopping, Merchant API mang lại một số lợi thế.
Tạo nguồn dữ liệu một cách rõ ràng. API này không còn tự động tạo nguồn dữ liệu "Content API" khi bạn chèn sản phẩm lần đầu tiên. Trong Merchant API, bạn phải tạo nguồn dữ liệu một cách rõ ràng trước khi có thể tải sản phẩm lên các nguồn dữ liệu đó. Điều này giúp bạn kiểm soát chặt chẽ hơn việc tổ chức và quản lý các quy trình dữ liệu sản phẩm ngay từ đầu.
Hỗ trợ nhiều nguồn dữ liệu API. Trong Content API for Shopping, bạn chỉ có thể sử dụng một nguồn dữ liệu "Content API" duy nhất được tạo tự động. Với Merchant API, bạn có thể tạo và quản lý nhiều nguồn dữ liệu thuộc kiểu đầu vào
API.Nguồn dữ liệu không có nhãn và ngôn ngữ. Merchant API cho phép bạn tạo một nguồn dữ liệu chính mà không cần chỉ định
feedLabelvàcontentLanguage. Loại nguồn dữ liệu này chấp nhận sản phẩm ở mọi tổ hợpfeedLabelvàcontentLanguage, giúp đơn giản hoá việc tải sản phẩm lên cho những tích hợp không yêu cầu nguồn dữ liệu riêng biệt cho các khu vực khác nhau.Đơn giản hoá mục tiêu dữ liệu. Mỗi nguồn dữ liệu hiện tương ứng với một đích đến duy nhất, được xác định bằng một tổ hợp duy nhất gồm
feedLabelvàcontentLanguage. Nguồn cấp dữ liệu nhắm đến nhiều dữ liệu không còn được dùng trong Merchant API.Trạng thái tải tệp lên chuyên dụng. Merchant API biểu thị trạng thái của các nguồn dữ liệu dựa trên tệp bằng cách sử dụng một tài nguyên
fileUploadsriêng biệt, chỉ đọc. Để truy xuất trạng thái của một tệp tải lên, hãy sử dụng phương thứcfileUploads.getvới bí danhlatest.Các loại nguồn dữ liệu mới. Tài nguyên
DataSourcehỗ trợ nhiều ngành dọc hơn, bao gồm cả chương trình khuyến mãi, kho hàng tại địa phương và kho hàng theo khu vực, mang đến một cách thức hợp nhất để quản lý tất cả các quy trình dữ liệu của bạn.Nguồn dữ liệu tự động. Với Merchant API, giờ đây, bạn có thể bật hoặc tắt tính năng Nguồn dữ liệu tự động cho tài khoản của mình bằng phương thức
autofeedSettings.updateAutofeedSettingstrong API phụ Tài khoản. Để biết thêm thông tin, hãy xem phần Định cấu hình chế độ cài đặt Nguồn cấp dữ liệu tự động.
Yêu cầu
Bảng sau đây so sánh các định dạng URL yêu cầu giữa Content API for Shopping và Merchant API.
| Nội dung mô tả yêu cầu | Content API for Shopping | Merchant API |
|---|---|---|
| Tạo một nguồn dữ liệu | POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds |
POST https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources |
| Lấy nguồn dữ liệu | GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds/{DATAFEED_ID} |
GET https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID} |
| Liệt kê nguồn dữ liệu | GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds |
GET https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources |
| Cập nhật nguồn dữ liệu | PUT https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds/{DATAFEED_ID} |
PATCH https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID} |
| Xoá nguồn dữ liệu | DELETE https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds/{DATAFEED_ID} |
DELETE https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID} |
| Tìm nạp một nguồn dữ liệu | POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds/{DATAFEED_ID}/fetchNow |
POST https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}:fetch |
| Lấy trạng thái nguồn dữ liệu | GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeedstatuses/{DATAFEED_ID} |
GET https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}/fileUploads/latest |
| Liệt kê các trạng thái nguồn dữ liệu | GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeedstatuses |
Không có. Sử dụng dataSources.list và fileUploads.get cho từng nguồn dữ liệu dựa trên tệp. |
Giá trị nhận dạng
Merchant API sử dụng tên tài nguyên dựa trên chuỗi làm giá trị nhận dạng.
| Thông tin mô tả về giá trị nhận dạng | Content API for Shopping | Merchant API |
|---|---|---|
| Giá trị nhận dạng nguồn dữ liệu | datafeedId (dạng số) |
name (chuỗi, định dạng: accounts/{account}/dataSources/{datasource}) |
Phương thức
Bảng này so sánh các phương thức của dịch vụ Content API for Shopping datafeeds và datafeedstatuses với các phương thức tương đương trong Merchant API.
| Phương thức Content API for Shopping | Phương thức Merchant API | Phạm vi cung cấp và ghi chú |
|---|---|---|
datafeeds.custombatch |
Không có | Thay vào đó, hãy sử dụng các lệnh gọi API riêng lẻ. |
datafeeds.delete |
dataSources.delete |
sức mạnh. |
datafeeds.fetchnow |
dataSources.fetch |
sức mạnh. Hiện tại, phương thức này chỉ hoạt động đối với các nguồn dữ liệu có đầu vào là tệp. |
datafeeds.get |
dataSources.get |
sức mạnh. |
datafeeds.insert |
dataSources.create |
sức mạnh. |
datafeeds.list |
dataSources.list |
sức mạnh. |
datafeeds.update |
dataSources.update |
sức mạnh. Sử dụng ngữ nghĩa PATCH thay vì PUT. |
datafeedstatuses.custombatch |
Không có | Thay vào đó, hãy sử dụng các lệnh gọi API riêng lẻ. Hãy xem phần Gửi nhiều yêu cầu cùng một lúc để biết thêm thông tin. |
datafeedstatuses.get |
fileUploads.get |
Áp dụng cho nguồn dữ liệu dựa trên tệp. Sử dụng bí danh latest để biết trạng thái của lần tải lên gần đây nhất. Đối với các loại nguồn dữ liệu khác, thông tin trạng thái là một phần của tài nguyên DataSource. |
datafeedstatuses.list |
Không có | Để biết trạng thái của nhiều nguồn dữ liệu, trước tiên, hãy liệt kê tất cả các nguồn dữ liệu bằng dataSources.list. Sau đó, hãy gọi fileUploads.get bằng bí danh latest cho từng nguồn dữ liệu dựa trên tệp. |
Thông tin chi tiết về các thay đổi đối với trường
Bảng này cho thấy những thay đổi ở cấp trường giữa tài nguyên Datafeed và DatafeedStatus trong Content API for Shopping, cũng như tài nguyên DataSource và FileUpload trong Merchant API.
| Content API for Shopping | Merchant API | Mô tả |
|---|---|---|
Datafeed |
DataSource |
Tài nguyên chính để định cấu hình nguồn dữ liệu. |
id |
name |
Giá trị nhận dạng tài nguyên. Đã thay đổi từ mã nhận dạng dạng số thành tên tài nguyên dạng chuỗi. |
name |
displayName |
Tên mà người dùng nhìn thấy của nguồn dữ liệu. |
attributeLanguage |
primaryProductDataSource.contentLanguage |
Mã ngôn ngữ gồm 2 chữ cái theo tiêu chuẩn ISO 639-1 của các mục trong nguồn dữ liệu. |
fileName |
fileInput.fileName |
Tên của tệp được tải lên. Trường này hiện được lồng trong fileInput. |
fetchSchedule |
fileInput.fetchSettings |
Lịch biểu để tìm nạp nguồn dữ liệu dựa trên tệp. Thao tác này hiện được lồng trong fileInput. |
fetchSchedule.paused |
fileInput.fetchSettings.enabled |
Logic bị đảo ngược. paused: true tương đương với enabled: false. |
format |
Không có | Các trường fileEncoding, columnDelimiter và quotingMode sẽ bị xoá. Những thông tin này hiện được phát hiện tự động. |
targets |
primaryProductDataSource.feedLabel, primaryProductDataSource.contentLanguage, primaryProductDataSource.countries |
Trường targets lặp lại đã bị xoá. Giờ đây, mỗi nguồn dữ liệu đều có một mục tiêu duy nhất được xác định bằng các trường này, phản ánh việc ngừng sử dụng nguồn cấp dữ liệu có nhiều mục tiêu dữ liệu. |
DatafeedStatus |
FileUpload |
Trạng thái tải tệp lên hiện là một tài nguyên riêng biệt, chỉ đọc. |
datafeedId |
name |
Giá trị nhận dạng cho tệp tải lên, tham chiếu đến nguồn dữ liệu gốc của tệp. |
processingStatus |
processingState |
Trạng thái xử lý của tệp tải lên. Các giá trị chuỗi (success, failure, in progress) được thay thế bằng một enum (SUCCEEDED, FAILED, IN_PROGRESS). |
errors, warnings |
issues |
Lỗi và cảnh báo được hợp nhất thành một danh sách issues duy nhất. Mỗi vấn đề đều có một trường severity (ERROR hoặc WARNING). |
lastUploadDate |
uploadTime |
Dấu thời gian của lần tải lên gần đây nhất. Định dạng đã thay đổi từ chuỗi thành đối tượng Timestamp. |
country, language, feedLabel |
Không áp dụng | Các trường này không còn nằm trên tài nguyên trạng thái nữa. Chúng là một phần của tài nguyên DataSource. |
targets[].included_destinations, targets[].excluded_destinations |
primaryProductDataSource.destinations |
Hai danh sách riêng biệt cho vị trí xuất hiện được đưa vào và vị trí xuất hiện bị loại trừ được thay thế bằng một danh sách destinations duy nhất. Mỗi mục trong danh sách mới là một đối tượng chỉ định đích đến và trạng thái của đích đến (ENABLED hoặc DISABLED), cung cấp một cấu hình rõ ràng hơn. |