צפייה בנתונים סטטיסטיים ובבעיות במוצרים

אפשר להשתמש בשיטה aggregateProductStatuses.list כדי לקבל סקירה כללית של סטטוס המוצרים בחשבון Merchant Center. האפשרות הזו שימושית למעקב אחרי המצב הכללי של נתוני המוצרים בלי שתצטרכו לאחזר כל מוצר בנפרד. בשיטה הזו מוצג המספר הכולל של המוצרים שלכם, עם פירוט לפי סטטוס (אושר, בהמתנה, נפסל), וגם רשימה של בעיות שמשפיעות על המוצרים.

שיקולים מיוחדים

יש שיקולים מיוחדים כשמשתמשים ב-method‏ 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 עם ה-method ‏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"
          ]
        }
      ]
    }
  ]
}