Di chuyển accountstatuses sang Aggregate Product Statuses

Cách bạn truy xuất các vấn đề và số liệu thống kê 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 biệt trong Merchant API. Hướng dẫn này giải thích cách di chuyển quy trình tích hợp để sử dụng tài nguyên mới aggregateProductStatuses.

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 được tách riêng. Bạn cũng nên xem hướng dẫn của chúng tôi để 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

Dưới đâ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 dụng: Tài nguyên accountstatuses từ 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ó 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 đại diện cho số liệu thống kê và các vấn đề đối với một tổ hợp cụ thể của 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ức list với chuỗi filter để truy vấn các bối cảnh báo cáo và quốc gia cụ thể.
  • Xoá trường kênh: Trường channel khô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ủa reportingContext.

Yêu cầu

Merchant API sử dụng yêu cầu GET với 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à các 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ả 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 đượ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ợ 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à ghi chú
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ề danh sách tài nguyên, một cho mỗi 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, 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 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 snake_case, 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.
Trước
Migrate accountstatuses to Account Issues
Tiếp
Migrate user and access management