העברה של סטטוסים של חשבונות לסטטוסים מצטברים של מוצרים
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
השתנה האופן שבו מאחזרים נתונים סטטיסטיים מצטברים של מוצרים ובעיות במוצרים. הפונקציונליות שהייתה זמינה בעבר במשאב 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
| תיאור הבקשה |
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. |
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-08 (שעון UTC).
[null,null,["עדכון אחרון: 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`. |"]]
