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

استخدِم طريقة 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"
          ]
        }
      ]
    }
  ]
}
السابق
Display issues and solutions to businesses