Melihat statistik dan masalah produk

Anda dapat menggunakan metode aggregateProductStatuses.list untuk mendapatkan ringkasan tingkat tinggi tentang status produk di akun Merchant Center Anda. Hal ini berguna untuk memantau keseluruhan kualitas data produk Anda tanpa perlu mengambil setiap produk satu per satu. Metode ini memberikan jumlah total produk yang Anda miliki, yang dikelompokkan berdasarkan status (disetujui, tertunda, tidak disetujui), dan juga mencantumkan masalah apa pun yang memengaruhi produk Anda.

Pertimbangan khusus

Ada pertimbangan khusus saat menggunakan metode aggregateProductStatuses.list.

• Ketersediaan data: Akan ada penundaan lebih dari 30 menit antara saat produk dimasukkan atau diperbarui dan saat statusnya ditampilkan dalam respons aggregateProductStatuses.
• Konsistensi masalah: Judul dan deskripsi masalah yang ditampilkan oleh metode aggregateProductStatuses.list dimaksudkan agar konsisten dengan masalah yang ditampilkan oleh Products API. Namun, deskripsi tersebut mungkin berbeda dengan deskripsi masalah yang ditampilkan di antarmuka pengguna Merchant Center.

Mendapatkan ringkasan semua status produk

Contoh ini menunjukkan cara mengambil daftar resource AggregateProductStatus. Setiap resource mewakili status produk untuk kombinasi tujuan dan negara tertentu. Memanggil aggregateProductStatuses.list tanpa parameter apa pun akan menampilkan semua status yang tersedia untuk akun Anda.

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

Berikut adalah contoh respons dari panggilan yang berhasil:

{
  "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"
          ]
        }
      ]
    }
  ]
}

Mendapatkan status produk untuk negara dan tujuan tertentu

Anda dapat memfilter hasil untuk melihat status negara dan tujuan tertentu menggunakan parameter kueri filter dengan metode aggregateProductStatuses.list. Misalnya: country = "US" AND reportingContext = "SHOPPING_ADS". Untuk mengetahui informasi selengkapnya, lihat Sintaksis filter.

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

Berikut adalah contoh respons dari panggilan yang berhasil:

{
  "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"
          ]
        }
      ]
    }
  ]
}