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

אתם יכולים להשתמש בשיטה 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/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 עם ה-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/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"
          ]
        }
      ]
    }
  ]
}