Cách bạn truy xuất số liệu thống kê và vấn đề tổng hợp về sản phẩm đã thay đổi. Chức năng trước đây có trong tài nguyên accountstatuses trong Content API for Shopping hiện được chia thành các tài nguyên riêng trong Merchant API. Hướng dẫn này giải thích cách di chuyển quá trình tích hợp để sử dụng tài nguyên aggregateProductStatuses mới.
Những điểm khác biệt chính
Sau đây là những điểm khác biệt chính giữa các tính năng về trạng thái sản phẩm trong Content API for Shopping và Merchant API:
- Tài nguyên chuyên biệt: Tài nguyên
accountstatusescủa Content API for Shopping hiện đã được tách riêng. Trong Merchant API, các vấn đề ở cấp tài khoản được cung cấp thông qua tài nguyênaccountissues, còn số liệu thống kê tổng hợp về sản phẩm và các vấn đề ở cấp mặt hàng được cung cấp thông qua tài nguyênaggregateProductStatusesmới. - Cấu trúc tài nguyên mới:
AggregateProductStatuslà một tài nguyên mới thể hiện số liệu thống kê và vấn đề cho một tổ hợp cụ thể gồm bối cảnh báo cáo và quốc gia. - Cơ chế lọc: Thay vì sử dụng các tham số truy vấn như
destinationsđể chọn dữ liệu, Merchant API sử dụng phương thứclistcó chuỗifilterđể truy vấn các bối cảnh và quốc gia báo cáo cụ thể. - Xoá trường kênh: Trường
channelkhông còn được sử dụng nữa. Thông tin này hiện là một phần ngầm định củareportingContext.
Yêu cầu
Merchant API sử dụng yêu cầu GET có tham số filter để truy xuất trạng thái tổng hợp của sản phẩm. Để biết thêm thông tin chi tiết về cú pháp bộ lọc, hãy xem phần Cú pháp bộ lọc.
GET https://merchantapi.googleapis.com/issueresolution/v1/{parent=accounts/*}/aggregateProductStatuses
Định dạng URL yêu cầu
| Nội dung mô tả yêu cầu | Content API for Shopping | Merchant API |
|---|---|---|
| Xem số liệu thống kê và vấn đề về sản phẩm | GET /content/v2.1/{merchantId}/accountstatuses/{accountId} |
GET /issueresolution/v1/accounts/{accountId}/aggregateProductStatuses |
Giá trị nhận dạng
Cách xác định tài nguyên đã thay đổi để hỗ trợ cấu trúc mới.
Định dạng giá trị nhận dạng
| Nội dung mô tả về giá trị nhận dạng | Content API for Shopping | Merchant API |
|---|---|---|
| Giá trị nhận dạng tài nguyên | Tài nguyên này do accountId xác định. Các lát dữ liệu cụ thể được chọn bằng tham số truy vấn. |
Tên tài nguyên xác định duy nhất dữ liệu cho một bối cảnh báo cáo và quốc gia cụ thể: accounts/{account}/aggregateProductStatuses/{reportingContext}~{country}. |
Phương thức
Phương thức truy xuất trạng thái sản phẩm đã được cập nhật thành phương thức list hỗ trợ tính năng lọc.
| Phương thức Content API for Shopping | Phương thức Merchant API | Phạm vi cung cấp và lưu ý |
|---|---|---|
accountstatuses.get |
aggregateProductStatuses.list |
Phương thức accountstatuses.get trả về một tài nguyên duy nhất chứa tất cả sản phẩm thống kê. Phương thức aggregateProductStatuses.list mới trả về danh sách tài nguyên, mỗi tài nguyên cho một tổ hợp bối cảnh báo cáo và quốc gia. Sử dụng tham số filter để truy xuất dữ liệu cụ thể. Đối với các vấn đề ở cấp tài khoản, hãy sử dụng accountissues.list. |
Thay đổi chi tiết về trường
Các trường cho số liệu thống kê và vấn đề về sản phẩm đã được cập nhật và tái cấu trúc trong tài nguyên AggregateProductStatus mới.
| Content API for Shopping | Merchant API | Mô tả |
|---|---|---|
products |
aggregate_product_statuses |
Mảng products được thay thế bằng trường lặp lại aggregate_product_statuses trong phản hồi danh sách. |
destination |
reporting_context |
Trường destination được thay thế bằng reporting_context, chỉ định bối cảnh chương trình cho số liệu thống kê. |
channel |
(không có trường tương đương) | Trường channel đã bị xoá. Thông tin này hiện là một phần của reporting_context. |
statistics |
stats |
Đối tượng statistics được đổi tên thành stats. Tên trường trong đó được chuyển đổi thành kiểu viết con rắn (viết thường chữ cái đầu tiên và thay dấu cách bằng dấu gạch dưới), ví dụ: activeCount hiện là active_count. |
itemLevelIssues.servability |
item_level_issues.severity |
Enum servability được thay thế bằng enum severity để mô tả tác động của một vấn đề. |
itemLevelIssues.attributeName |
item_level_issues.attribute |
Trường attributeName được đổi tên thành attribute. |
itemLevelIssues.documentation |
item_level_issues.documentation_uri |
Trường documentation được đổi tên thành documentation_uri. |
itemLevelIssues.numItems |
item_level_issues.product_count |
Trường numItems được đổi tên thành product_count. |