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

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

ملاحظات خاص

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

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

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

این مثال نحوه بازیابی لیستی از منابع AggregateProductStatus را نشان می دهد. هر منبع نشان دهنده وضعیت محصولات برای ترکیب خاصی از مقصد و کشور است. فراخوانی aggregateProductStatuses.list بدون هیچ پارامتری همه وضعیت های موجود را برای حساب شما برمی گرداند.

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

در اینجا یک نمونه پاسخ از یک تماس موفق است:

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

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

با استفاده از پارامتر query 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/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"
          ]
        }
      ]
    }
  ]
}