نقل حالات الحساب إلى حالات المنتجات المجمّعة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
لقد تغيّرت الطريقة التي تستردّ بها الإحصاءات والمشاكل المجمّعة المتعلّقة بالمنتجات. تم الآن تقسيم الوظائف التي كانت متوفّرة سابقًا في المرجع 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 مستخدَمًا. أصبحت هذه المعلومات الآن جزءًا ضمنيًا من reportingContext.
الطلبات
تستخدم Merchant API طلب GET مع المَعلمة filter لاسترداد حالات المنتجات المجمّعة.
GET
https://merchantapi.googleapis.com/issueresolution/v1/{parent=accounts/*}/aggregateProductStatuses
| وصف الطلب |
واجهة برمجة تطبيقات المحتوى في Shopping |
Merchant API |
| الحصول على إحصاءات ومشاكل المنتجات |
GET /content/v2.1/{merchantId}/accountstatuses/{accountId} |
GET /issueresolution/v1/accounts/{accountId}/aggregateProductStatuses |
المعرّفات
تغيّرت طريقة تحديد المراجع لتتوافق مع البنية الجديدة.
| وصف المعرّف |
واجهة برمجة تطبيقات المحتوى في Shopping |
Merchant API |
| معرّف المورد |
تم تحديد المرجع من خلال accountId. تم اختيار شرائح بيانات محدّدة باستخدام مَعلمات طلب البحث. |
يحدّد اسم المورد البيانات بشكل فريد لسياق تقارير وبلد معيّنَين: accounts/{account}/aggregateProductStatuses/{reportingContext}~{country}. |
الطُرق
تم تعديل طريقة استرداد حالات المنتجات إلى طريقة list
تتيح الفلترة.
| طريقة Content API for Shopping |
طريقة Merchant API |
التوفّر والملاحظات |
accountstatuses.get |
aggregateProductStatuses.list |
عرضت الطريقة accountstatuses.get موردًا واحدًا يحتوي على جميع إحصاءات المنتجات. تعرض طريقة aggregateProductStatuses.list الجديدة قائمة بالموارد، مورد واحد لكل تركيبة من سياق إعداد التقارير والبلد. استخدِم المَعلمة filter لاسترداد بيانات معيّنة. بالنسبة إلى المشاكل على مستوى الحساب، استخدِم accountissues.list. |
تغييرات الحقول التفصيلية
تم تعديل حقول إحصاءات المنتجات والمشاكل وإعادة هيكلتها
في المرجع الجديد AggregateProductStatus.
| واجهة برمجة تطبيقات المحتوى في 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 |
تم استبدال التعداد servability بالتعداد 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 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-08 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],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`. |"]]
