روش بازیابی آمار و مشکلات انبوه محصول تغییر کرده است. عملکردی که قبلاً در منبع 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 تغییر نام داده است. |