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