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

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

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

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