השתנה האופן שבו מאחזרים נתונים סטטיסטיים מצטברים של מוצרים ובעיות במוצרים. הפונקציונליות שהייתה זמינה בעבר במשאב accountstatuses ב-Content API for Shopping מחולקת עכשיו למשאבים ייעודיים ב-Merchant API. במדריך הזה מוסבר איך להעביר את השילוב לשימוש במשאב החדש aggregateProductStatuses.
הערה: ב-Merchant API, הבעיות ברמת החשבון וסטטוס המוצרים המצטבר מפוצלים. כדאי גם לעיין במדריך שלנו בנושא מעבר מ-accountstatuses אל בעיות בחשבון.
ההבדלים העיקריים
ריכזנו כאן את ההבדלים העיקריים בין התכונות של סטטוס המוצר ב-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 |
השיטה accountstatuses.get החזירה משאב יחיד שמכיל את כל נתוני המוצרים. ה-method החדש 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. |