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

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

ملاحظات ویژه

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

  • دردسترس بودن داده‌ها: انتظار تأخیری بیش‌از ۳۰ دقیقه بین زمانی که محصولی درج یا به‌روز می‌شود و زمانی که وضعیت آن در پاسخ 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