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

Sử dụng phương thức aggregateProductStatuses.list để xem thông tin tổng quan về trạng thái của các sản phẩm trong tài khoản Merchant Center. Điều này giúp bạn 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 chia theo trạng thái (được 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 lưu ý đặc biệt khi sử dụng phương thức aggregateProductStatuses.list.

• Thời gian có dữ liệu: Dự kiến sẽ có độ trễ hơn 30 phút từ thời điểm sản phẩm được chèn hoặc cập nhật đến thời điểm trạng thái của sản phẩm được phản ánh 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 API Sản phẩm trả về. Tuy nhiên, các nội dung này có thể khác với nội dung mô tả vấ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 vị trí xuất hiện và quốc gia. Khi bạn gọi aggregateProductStatuses.list mà không có tham số nào, tất cả trạng thái hiện có cho tài khoản của bạn sẽ được trả về.

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

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