عرض إحصاءات المنتج والمشاكل المتعلّقة به

استخدِم طريقة aggregateProductStatuses.list للحصول على نظرة عامة عالية المستوى على حالة المنتجات في حسابك على Merchant Center. ويُعدّ ذلك مفيدًا لمراقبة الحالة العامة لبيانات منتجاتك بدون الحاجة إلى جلب كل منتج على حدة. توفّر هذه الطريقة إجمالي عدد المنتجات لديك، مقسّمة حسب الحالة (موافَق عليها، في انتظار المراجعة، مرفوضة)، كما تسرد أي مشاكل تؤثر في منتجاتك.

اعتبارات خاصة

هناك اعتبارات خاصة عند استخدام طريقة aggregateProductStatuses.list.

• توفّر البيانات: يُرجى توقّع تأخير لأكثر من 30 دقيقة بين وقت إدراج منتج أو تعديله ووقت ظهور حالته في استجابة aggregateProductStatuses.
• اتساق المشاكل: تهدف عناوين المشاكل وأوصافها التي تعرضها طريقة aggregateProductStatuses.list إلى أن تكون متسقة مع المشاكل التي تعرضها Products API. ومع ذلك، قد تختلف عن أوصاف المشاكل المعروضة في واجهة مستخدم Merchant Center.

نظرة عامة على جميع حالات المنتجات

يوضّح هذا المثال كيفية استرداد قائمة بموارد AggregateProductStatus. يمثّل كل مورد حالة المنتجات لمجموعة معيّنة من الوجهات والبلدان. يؤدي استدعاء aggregateProductStatuses.list بدون أي مَعلمات إلى عرض جميع الحالات المتاحة لحسابك.

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

في ما يلي نموذج ردّ من طلب ناجح:

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

الحصول على حالات المنتجات لبلد ووجهة معيّنين

يمكنك فلترة النتائج للاطّلاع على حالة بلد ووجهة معيّنين باستخدام مَعلمة طلب البحث filter مع طريقة aggregateProductStatuses.list. مثلاً: country = "US" AND reportingContext = "SHOPPING_ADS". لمزيد من المعلومات التفصيلية حول بنية الفلتر، يُرجى الاطّلاع على بنية الفلتر.

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

في ما يلي نموذج ردّ من طلب ناجح:

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