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