Di chuyển accountstatuses sang Aggregate Product Statuses

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 chuyên dụng trong Merchant API. Hướng dẫn này giải thích cách di chuyển hoạt động tích hợp để sử dụng tài nguyên aggregateProductStatuses mới.

Lưu ý: Trong Merchant API, các vấn đề ở cấp tài khoản và trạng thái tổng hợp của sản phẩm sẽ được tách riêng. Bạn cũng nên tham khảo hướng dẫn của chúng tôi về cách di chuyển từ accountstatuses sang các vấn đề về tài khoản.

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 trạng thái sản phẩm trong Content API for Shopping và Merchant API:

• Tài nguyên chuyên dụng: Tài nguyên accountstatuses trong Content API for Shopping hiện đã được tách ra. Trong Merchant API, các vấn đề ở cấp tài khoản có sẵn thông qua tài nguyên accountissues, trong khi 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ó sẵn thông qua tài nguyên aggregateProductStatuses mới.
• Cấu trúc tài nguyên mới: AggregateProductStatus là 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ể của bối cảnh báo cáo và một 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ức list với chuỗi filter để truy vấn các quốc gia và bối cảnh báo cáo cụ thể.
• Xoá trường kênh: Trường channel không còn được dùng nữa. Thông tin này hiện là một phần ngầm định của reportingContext.

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.

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
Nhận 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

Thông tin 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 được xác định bằng accountId. Các lát dữ liệu cụ thể được chọn bằng các 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ợ 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ố liệu thống kê về sản phẩm. Phương thức aggregateProductStatuses.list mới trả về một danh sách tài nguyên, mỗi tài nguyên cho một tổ hợp ngữ 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.

Thông tin chi tiết về các thay đổi đối với trường

Các trường về số liệu thống kê và vấn đề của 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. Trường này 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 sẽ bị xoá. Thông tin này hiện thuộc 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 snake_case, ví dụ: activeCount giờ đây là active_count.
itemLevelIssues.servability	item_level_issues.severity	Enum servability được thay thế bằng enum severity để mô tả mức độ ảnh hưở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.