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