Xem số liệu thống kê và vấn đề về sản phẩm

Bạn có thể sử dụng phương thức aggregateProductStatuses.list để xem thông tin tổng quan cấp cao về trạng thái của các sản phẩm trong tài khoản Merchant Center. Điều này hữu ích cho việc theo dõi tình trạng tổng thể của dữ liệu sản phẩm mà không cần tìm nạp từng sản phẩm riêng lẻ. Phương thức này cung cấp tổng số sản phẩm bạn có, được phân loại theo trạng thái (được chấp thuận, đang chờ xử lý, bị từ chối) và cũng liệt kê mọi vấn đề đang ảnh hưởng đến sản phẩm của bạn.

Các điểm cần cân nhắc đặc biệt

Có những điểm đặc biệt cần cân nhắc khi sử dụng phương thức aggregateProductStatuses.list.

• Tính sẵn có của dữ liệu: Bạn có thể phải đợi hơn 30 phút từ khi một sản phẩm được chèn hoặc cập nhật cho đến khi trạng thái của sản phẩm đó xuất hiện trong phản hồi aggregateProductStatuses.
• Tính nhất quán của vấn đề: Tiêu đề và nội dung mô tả vấn đề do phương thức aggregateProductStatuses.list trả về phải nhất quán với các vấn đề do Products API trả về. Tuy nhiên, nội dung này có thể khác với nội dung mô tả vấn đề xuất hiện trong giao diện người dùng của Merchant Center.

Xem thông tin tổng quan về tất cả trạng thái sản phẩm

Ví dụ này cho thấy cách truy xuất danh sách tài nguyên AggregateProductStatus. Mỗi tài nguyên đại diện cho trạng thái của sản phẩm cho một tổ hợp cụ thể gồm đích đến và quốc gia. Gọi aggregateProductStatuses.list mà không có bất kỳ tham số nào sẽ trả về tất cả trạng thái hiện có cho tài khoản của bạn.

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/aggregateProductStatuses

Sau đây là một phản hồi mẫu từ một lệnh gọi thành công:

{
  "aggregateProductStatuses": [
    {
      "name": "accounts/12345/aggregateProductStatuses/SHOPPING_ADS~US",
      "reportingContext": "SHOPPING_ADS",
      "countryCode": "US",
      "statistics": {
        "approvedCount": "1500",
        "pendingCount": "50",
        "disapprovedCount": "25"
      },
      "issues": [
        {
          "issueType": "missing_image",
          "severity": "ERROR",
          "numProducts": "15",
          "sampleProducts": [
            "accounts/12345/products/online~en~US~SKU001",
            "accounts/12345/products/online~en~US~SKU002"
          ]
        },
        {
          "issueType": "invalid_price",
          "severity": "CRITICAL",
          "numProducts": "10",
          "sampleProducts": [
            "accounts/12345/products/online~en~US~SKU003"
          ]
        }
      ]
    },
    {
      "name": "accounts/12345/aggregateProductStatuses/FREE_LISTINGS~US",
      "reportingContext": "FREE_LISTINGS",
      "countryCode": "US",
      "statistics": {
        "approvedCount": "1510",
        "pendingCount": "50",
        "disapprovedCount": "15"
      },
      "issues": [
        {
          "issueType": "missing_image",
          "severity": "ERROR",
          "numProducts": "15",
          "sampleProducts": [
            "accounts/12345/products/online~en~US~SKU001",
            "accounts/12345/products/online~en~US~SKU002"
          ]
        }
      ]
    }
  ]
}

Nhận trạng thái sản phẩm cho một quốc gia và vị trí xuất hiện cụ thể

Bạn có thể lọc kết quả để xem trạng thái của một quốc gia và đích đến cụ thể bằng cách sử dụng tham số truy vấn filter với phương thức aggregateProductStatuses.list. Ví dụ: country = "US" AND reportingContext = "SHOPPING_ADS". Để biết thêm thông tin, hãy xem phần Cú pháp bộ lọc.

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/aggregateProductStatuses?filter=countryCode%3D"US"%20AND%20reportingContext%3D"SHOPPING_ADS"

Sau đây là một phản hồi mẫu từ một lệnh gọi thành công:

{
  "aggregateProductStatuses": [
    {
      "name": "accounts/12345/aggregateProductStatuses/SHOPPING_ADS~US",
      "reportingContext": "SHOPPING_ADS",
      "countryCode": "US",
      "statistics": {
        "approvedCount": "1500",
        "pendingCount": "50",
        "disapprovedCount": "25"
      },
      "issues": [
        {
          "issueType": "missing_image",
          "severity": "ERROR",
          "numProducts": "15",
          "sampleProducts": [
            "accounts/12345/products/online~en~US~SKU001",
            "accounts/12345/products/online~en~US~SKU002"
          ]
        },
        {
          "issueType": "invalid_price",
          "severity": "CRITICAL",
          "numProducts": "10",
          "sampleProducts": [
            "accounts/12345/products/online~en~US~SKU003"
          ]
        }
      ]
    }
  ]
}