העברה של סטטוסים של חשבונות לסטטוסים מצטברים של מוצרים
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
השתנה האופן שבו מאחזרים נתונים סטטיסטיים מצטברים של מוצרים ובעיות במוצרים. הפונקציונליות שהייתה זמינה בעבר במשאב 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.
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-08-08 (שעון UTC)."],[],[],null,["# Migrate accountstatuses to Aggregate Product Statuses\n\nThe way you retrieve aggregated product statistics and issues has changed. The\nfunctionality previously available in the `accountstatuses` resource in the\nContent API for Shopping is now split into dedicated resources in the Merchant\nAPI. This guide explains how to migrate your integration to use the new\n[`aggregateProductStatuses`](/merchant/api/reference/rest/issueresolution_v1/accounts.aggregateProductStatuses)\nresource.\n\n**Note** : In Merchant API, account-level issues and aggregate product statuses\nare split. Also review our guide to migrate from `accountstatuses` to\n[account issues](/merchant/api/guides/compatibility/migrate-view-issues).\n\nKey differences\n---------------\n\nHere are the key differences between the product status features in Content\nAPI for Shopping and Merchant API:\n\n- **Dedicated resources** : The `accountstatuses` resource from Content API for Shopping is now split. In Merchant API, account-level issues are available through the [`accountissues`](/merchant/api/reference/rest/accounts_v1/accounts.issues) resource, while aggregated product statistics and item-level issues are available through the new [`aggregateProductStatuses`](/merchant/api/reference/rest/issueresolution_v1/accounts.aggregateProductStatuses) resource.\n- **New resource structure** : `AggregateProductStatus` is a new resource that represents the statistics and issues for a specific combination of a reporting context and a country.\n- **Filtering mechanism** : Instead of using query parameters like `destinations` to select data, Merchant API uses a `list` method with a `filter` string to query for specific reporting contexts and countries.\n- **Channel field removal** : The `channel` field is no longer used. This information is now implicitly part of the `reportingContext`.\n\nRequests\n--------\n\nMerchant API uses a `GET` request with a `filter` parameter to retrieve\naggregated product statuses.\n\n`GET\nhttps://merchantapi.googleapis.com/issueresolution/v1/{parent=accounts/*}/aggregateProductStatuses`\n\n### Request URL format\n\n| Request description | Content API for Shopping | Merchant API |\n|-----------------------------------|--------------------------------------------------------------|-------------------------------------------------------------------------|\n| Get product statistics and issues | `GET /content/v2.1/{merchantId}/accountstatuses/{accountId}` | `GET /issueresolution/v1/accounts/{accountId}/aggregateProductStatuses` |\n\nIdentifiers\n-----------\n\nThe way resources are identified has changed to support the new structure.\n\n### Identifier format\n\n| Identifier description | Content API for Shopping | Merchant API |\n|------------------------|-------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Resource Identifier | The resource was identified by `accountId`. Specific data slices were selected with query parameters. | The resource name uniquely identifies the data for a specific reporting context and country: `accounts/{account}/aggregateProductStatuses/{reportingContext}~{country}`. |\n\nMethods\n-------\n\nThe method for retrieving product statuses has been updated to a `list` method\nthat supports filtering.\n\n| Content API for Shopping method | Merchant API method | Availability \\& notes |\n|---------------------------------|---------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `accountstatuses.get` | `aggregateProductStatuses.list` | The `accountstatuses.get` method returned a single resource containing all product statistics. The new `aggregateProductStatuses.list` method returns a list of resources, one for each reporting context and country combination. Use the `filter` parameter to retrieve specific data. For account-level issues, use `accountissues.list`. |\n\nDetailed field changes\n----------------------\n\nThe fields for product statistics and issues have been updated and restructured\nin the new `AggregateProductStatus` resource.\n\n| Content API for Shopping | Merchant API | Description |\n|---------------------------------|---------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------|\n| `products` | `aggregate_product_statuses` | The `products` array is replaced by the `aggregate_product_statuses` repeated field in the list response. |\n| `destination` | `reporting_context` | The `destination` field is replaced by `reporting_context`, which specifies the program context for the stats. |\n| `channel` | (no equivalent field) | The `channel` field is removed. This information is now part of the `reporting_context`. |\n| `statistics` | `stats` | The `statistics` object is renamed to `stats`. Field names within are converted to snake_case, for example, `activeCount` is now `active_count`. |\n| `itemLevelIssues.servability` | `item_level_issues.severity` | The `servability` enum is replaced by the `severity` enum to describe the impact of an issue. |\n| `itemLevelIssues.attributeName` | `item_level_issues.attribute` | The field `attributeName` is renamed to `attribute`. |\n| `itemLevelIssues.documentation` | `item_level_issues.documentation_uri` | The field `documentation` is renamed to `documentation_uri`. |\n| `itemLevelIssues.numItems` | `item_level_issues.product_count` | The field `numItems` is renamed to `product_count`. |"]]
