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

Bạn có thể sử dụng aggregateProductStatuses.list phương thức để 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. Phương thức này hữu ích cho việc giám sát 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 mà bạn có, được phân chia theo trạng thái (đã phê duyệt, đ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ó một số điểm cần cân nhắc đặc biệt khi sử dụng phương thức aggregateProductStatuses.list.

• Tính sẵn có của dữ liệu: Bạn nên dự kiến sẽ có độ trễ hơn 30 phút giữa thời điểm một sản phẩm được chèn hoặc cập nhật và thời điểm trạng thái của sản phẩm đó được phản ánh trong aggregateProductStatuses phản hồi.
• 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 API Sản phẩm trả về. Tuy nhiên, các tiêu đề và nội dung mô tả 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 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 biết 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 các sản phẩm đối với một tổ hợp cụ thể gồm vị trí xuất hiện và quốc gia. Việc gọi aggregateProductStatuses.list mà không có tham số 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

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

{
  "aggregateProductStatuses": [
    {
      "name": "accounts/{ACCOUNT_ID}/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/{ACCOUNT_ID}/products/online~en~US~SKU001",
            "accounts/{ACCOUNT_ID}/products/online~en~US~SKU002"
          ]
        },
        {
          "issueType": "invalid_price",
          "severity": "CRITICAL",
          "numProducts": "10",
          "sampleProducts": [
            "accounts/{ACCOUNT_ID}/products/online~en~US~SKU003"
          ]
        }
      ]
    },
    {
      "name": "accounts/{ACCOUNT_ID}/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/{ACCOUNT_ID}/products/online~en~US~SKU001",
            "accounts/{ACCOUNT_ID}/products/online~en~US~SKU002"
          ]
        }
      ]
    }
  ]
}

Xem 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 cho một quốc gia và vị trí xuất hiệ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 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"

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

{
  "aggregateProductStatuses": [
    {
      "name": "accounts/{ACCOUNT_ID}/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/{ACCOUNT_ID}/products/online~en~US~SKU001",
            "accounts/{ACCOUNT_ID}/products/online~en~US~SKU002"
          ]
        },
        {
          "issueType": "invalid_price",
          "severity": "CRITICAL",
          "numProducts": "10",
          "sampleProducts": [
            "accounts/{ACCOUNT_ID}/products/online~en~US~SKU003"
          ]
        }
      ]
    }
  ]
}