مشاهده آمار و مشکلات محصول

شما می‌توانید از متد aggregateProductStatuses.list برای دریافت یک نمای کلی از وضعیت محصولات در حساب مرکز فروشندگان خود استفاده کنید. این متد برای نظارت بر سلامت کلی داده‌های محصول شما بدون نیاز به دریافت تک تک محصولات مفید است. این متد تعداد کل محصولات شما را بر اساس وضعیت (تأیید شده، در انتظار، رد شده) و همچنین هرگونه مشکلی که بر محصولات شما تأثیر می‌گذارد، ارائه می‌دهد.

ملاحظات ویژه

هنگام استفاده از متد aggregateProductStatuses.list ملاحظات خاصی وجود دارد.

• در دسترس بودن داده‌ها : انتظار می‌رود بین زمانی که یک محصول درج یا به‌روزرسانی می‌شود و زمانی که وضعیت آن در پاسخ aggregateProductStatuses منعکس می‌شود، بیش از 30 دقیقه تأخیر وجود داشته باشد.
• سازگاری با مشکلات : عناوین و توضیحات مشکلات که توسط متد aggregateProductStatuses.list برگردانده می‌شوند، با مشکلاتی که توسط Products API برگردانده می‌شوند، سازگار هستند. با این حال، ممکن است با توضیحات مشکلات نشان داده شده در رابط کاربری مرکز فروشندگان متفاوت باشند.

نمای کلی از وضعیت همه محصولات را دریافت کنید

این مثال نحوه بازیابی لیستی از منابع 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/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"
          ]
        }
      ]
    }
  ]
}

وضعیت محصولات را برای یک کشور و مقصد خاص دریافت کنید

شما می‌توانید با استفاده از پارامتر کوئری filter به همراه متد aggregateProductStatuses.list ، نتایج را فیلتر کنید تا وضعیت یک کشور و مقصد خاص را مشاهده کنید. برای مثال: country = "US" AND reportingContext = "SHOPPING_ADS" . برای اطلاعات بیشتر، به Filter syntax مراجعه کنید.

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