השתנה האופן שבו מאחזרים נתונים סטטיסטיים מצטברים של מוצרים ובעיות. הפונקציונליות שהייתה זמינה בעבר במשאב accountstatuses ב-Content API for Shopping מחולקת עכשיו למשאבים ייעודיים ב-Merchant API. במדריך הזה מוסבר איך להעביר את השילוב לשימוש במשאב aggregateProductStatuses החדש.
ההבדלים העיקריים
ריכזנו כאן את ההבדלים העיקריים בין התכונות של סטטוס המוצר ב-Content API for Shopping וב-Merchant API:
- משאבים ייעודיים: המשאב
accountstatusesמ-Content API for Shopping פוצל. ב-Merchant API, בעיות ברמת החשבון זמינות דרך מקור המידעaccountissues, ואילו נתונים סטטיסטיים מצטברים של מוצרים ובעיות ברמת הפריט זמינים דרך מקור המידע החדשaggregateProductStatuses. - מבנה משאבים חדש:
AggregateProductStatusהוא משאב חדש שמייצג את הנתונים הסטטיסטיים והבעיות בשילוב ספציפי של הקשר דיווח ומדינה. - מנגנון סינון: במקום להשתמש בפרמטרים של שאילתות כמו
destinationsכדי לבחור נתונים, Merchant API משתמש בשיטהlistעם מחרוזתfilterכדי לשלוף נתונים של הקשרים ומדינות ספציפיים בדוחות. - הסרת השדה Channel: השדה
channelלא נמצא יותר בשימוש. המידע הזה הוא עכשיו חלק מ-reportingContext.
בקשות
ב-Merchant API משתמשים בבקשת GET עם הפרמטר filter כדי לאחזר סטטוסים מצטברים של מוצרים. מידע מפורט יותר על תחביר המסננים זמין במאמר בנושא תחביר המסננים.
GET https://merchantapi.googleapis.com/issueresolution/v1/{parent=accounts/*}/aggregateProductStatuses
הפורמט של כתובת ה-URL של הבקשה
| תיאור הבקשה | Content API for Shopping | Merchant API |
|---|---|---|
| קבלת נתונים סטטיסטיים ובעיות במוצרים | GET /content/v2.1/{merchantId}/accountstatuses/{accountId} |
GET /issueresolution/v1/accounts/{accountId}/aggregateProductStatuses |
מזהים
השתנה האופן שבו המערכת מזהה משאבים, כדי לתמוך במבנה החדש.
פורמט של מזהה
| תיאור המזהה | Content API for Shopping | Merchant API |
|---|---|---|
| מזהה משאב | המשאב זוהה על ידי accountId. פלחים ספציפיים של נתונים נבחרו באמצעות פרמטרים של שאילתה. |
שם המשאב מזהה באופן ייחודי את הנתונים בהקשר דיווח ובמדינה ספציפיים: accounts/{account}/aggregateProductStatuses/{reportingContext}~{country}. |
Methods
השיטה לאחזור סטטוסי מוצרים עודכנה לשיטת list שתומכת בסינון.
| שיטה של Content API for Shopping | שיטת Merchant API | זמינות והערות |
|---|---|---|
accountstatuses.get |
aggregateProductStatuses.list |
ה-method accountstatuses.get החזירה משאב יחיד שמכיל את כל נתוני המוצרים. השיטה החדשה aggregateProductStatuses.list מחזירה רשימה של משאבים, אחד לכל שילוב של הקשר הדיווח והמדינה. משתמשים בפרמטר filter כדי לאחזר נתונים ספציפיים. לבעיות ברמת החשבון, משתמשים ב-accountissues.list. |
שינויים מפורטים בשדות
השדות של נתוני המוצרים והבעיות שזוהו בהם עודכנו ועברו ארגון מחדש במשאב AggregateProductStatus החדש.
| Content API for Shopping | Merchant API | תיאור |
|---|---|---|
products |
aggregate_product_statuses |
המערך products מוחלף בשדה החוזר aggregate_product_statuses בתגובת הרשימה. |
destination |
reporting_context |
השדה destination מוחלף בשדה reporting_context, שמציין את הקשר התוכנית לנתונים הסטטיסטיים. |
channel |
(אין שדה מקביל) | השדה channel הוסר. המידע הזה הוא עכשיו חלק מ-reporting_context. |
statistics |
stats |
השם של האובייקט statistics משתנה ל-stats. שמות השדות בתוך המערך מומרים ל-snake_case, לדוגמה, activeCount הופך ל-active_count. |
itemLevelIssues.servability |
item_level_issues.severity |
ה-enum servability הוחלף ב-enum severity כדי לתאר את ההשפעה של בעיה. |
itemLevelIssues.attributeName |
item_level_issues.attribute |
השם של השדה attributeName השתנה ל-attribute. |
itemLevelIssues.documentation |
item_level_issues.documentation_uri |
השם של השדה documentation השתנה ל-documentation_uri. |
itemLevelIssues.numItems |
item_level_issues.product_count |
השם של השדה numItems השתנה ל-product_count. |