با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
روش بازیابی آمار و مشکلات انبوه محصول تغییر کرده است. عملکردی که قبلاً در منبع accountstatuses در Content API برای خرید موجود بود، اکنون به منابع اختصاصی در Merchant API تقسیم شده است. این راهنما نحوه انتقال ادغام خود را برای استفاده از منبع جدید aggregateProductStatuses توضیح می دهد.
توجه : در Merchant API، مسائل مربوط به سطح حساب و وضعیت کل محصول تقسیم می‌شوند. همچنین راهنمای ما برای مهاجرت از accountstatuses به مشکلات حساب را مرور کنید.
تفاوت های کلیدی
در اینجا تفاوت های اصلی بین ویژگی های وضعیت محصول در Content API برای خرید و Merchant API آمده است:
منابع اختصاصی : منبع accountstatuses از Content API برای خرید اکنون تقسیم شده است. در 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
فرمت URL را درخواست کنید
درخواست توضیحات
Content API برای خرید
Merchant API
آمار و مشکلات محصول را دریافت کنید
GET /content/v2.1/{merchantId}/accountstatuses/{accountId}
GET /issueresolution/v1/accounts/{accountId}/aggregateProductStatuses
شناسه ها
روش شناسایی منابع برای پشتیبانی از ساختار جدید تغییر کرده است.
فرمت شناسه
شرح شناسه
Content API برای خرید
Merchant API
شناسه منبع
منبع توسط accountId شناسایی شد. برش های داده خاص با پارامترهای پرس و جو انتخاب شدند.
نام منبع به طور منحصربه‌فرد داده‌ها را برای زمینه و کشور گزارش‌دهی خاص شناسایی می‌کند: accounts/{account}/aggregateProductStatuses/{reportingContext}~{country} .
روش ها
روش بازیابی وضعیت محصول به روش list به روز شده است که از فیلتر کردن پشتیبانی می کند.
Content API برای روش خرید
روش Merchant API
در دسترس بودن و یادداشت ها
accountstatuses.get
aggregateProductStatuses.list
روش accountstatuses.get یک منبع واحد حاوی تمام آمار محصول را برگرداند. روش جدید aggregateProductStatuses.list فهرستی از منابع را برمی‌گرداند، یکی برای هر بافت گزارش و ترکیب کشور. از پارامتر filter برای بازیابی داده های خاص استفاده کنید. برای مشکلات سطح حساب، از accountissues.list استفاده کنید.
تغییرات میدان دقیق
فیلدهای مربوط به آمار و مسائل مربوط به محصول در منبع جدید AggregateProductStatus به روز شده و بازسازی شده است.
Content API برای خرید
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 تغییر نام داده است.
تاریخ آخرین بهروزرسانی 2025-08-08 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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 بهوقت ساعت هماهنگ جهانی."],[],[],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`. |"]]
