השתנה האופן שבו מאחזרים נתונים סטטיסטיים מצטברים של מוצרים ובעיות. הפונקציונליות שהייתה זמינה בעבר במקור המידע 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 החזירה משאב יחיד שמכיל את כל נתוני המוצרים. ה-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. |