نحوه بازیابی مشکلات سطح حساب که میتوانند بر محصولات و سلامت حساب شما تأثیر بگذارند، تغییر کرده است. در مقایسه با منبع accountstatuses در Content API for Shopping، Merchant API یک منبع اختصاصی AccountIssue معرفی میکند که اطلاعات ساختاریافتهتر و دقیقتری ارائه میدهد.
برای اطلاعات بیشتر در مورد نحوه استفاده از ویژگی جدید، به راهنمای مشاهده مشکلات حساب مراجعه کنید.
توجه : در رابط برنامهنویسی کاربردی فروشنده، مشکلات سطح حساب کاربری و وضعیتهای تجمیعی محصول از هم جدا شدهاند. همچنین راهنمای ما برای مهاجرت از accountstatuses به وضعیتهای تجمیعی محصول را بررسی کنید.
تفاوتهای کلیدی
در اینجا پیشرفتها و تفاوتهای کلیدی در منبع Merchant API AccountIssue آمده است:
- منبع اختصاصی: مشکلات حساب، منبع جداگانهای هستند. در Content API for Shopping، مشکلات سطح حساب، یک فیلد تو در تو در منبع عمومی
AccountStatusبودند. با Merchant API میتوانید آنها را مستقیماً با استفاده از متدaccounts.issues.listفهرست کنید. - دادههای تأثیر ساختاریافته: منبع
AccountIssueیک فیلدimpactedDestinationsبا جزئیات ارائه میدهد. این فیلد به شما تجزیه و تحلیل روشنی از تأثیر یک مشکل، از جمله مقصد (به عنوان مثال، تبلیغات خرید)، منطقه خاص و شدت مشکل در آن منطقه را ارائه میدهد. - شدت به عنوان یک enum: فیلد
severityاکنون یک enum است (با مقادیری مانندCRITICAL،ERROR،SUGGESTION)، که پردازش برنامهنویسی آن را در مقایسه با مقادیر مبتنی بر رشته در Content API برای خرید آسانتر میکند. - شناسههای استاندارد: هر شماره حساب دارای یک
nameمنبع کامل و منحصر به فرد در قالبaccounts/{ACCOUNT_ID}/issues/{ISSUE_ID}است. این رویکرد استاندارد، رشتهidرا از Content API for Shopping جایگزین میکند. - پشتیبانی از محلیسازی: متد
accounts.issues.listبه شما امکان میدهد یکlanguage_codeبرای دریافت جزئیات مشکل، مانند عنوان و توضیحات، به زبان دلخواه خود مشخص کنید. این امکان در Content API for Shopping وجود نداشت. - رفتار حساب پیشرفته: وقتی
accounts.issues.listرا روی یک حساب پیشرفته فراخوانی میکنید، فقط مشکلاتی را که مستقیماً به آن حساب پیشرفته مربوط میشوند، برمیگرداند. این تابع مشکلات هیچ یک از زیرحسابهای آن را برنمیگرداند. در Content API برای خرید، متدaccountstatuses.listوضعیت همه زیرحسابها را برمیگرداند. برای دریافت مشکلات همه زیرحسابها در Merchant API، بایدaccounts.listSubaccountsفراخوانی کنید و سپسaccounts.issues.listرا برای هر زیرحساب به صورت جداگانه فراخوانی کنید.
درخواستها
در رابط برنامهنویسی کاربردی فروشگاه، میتوانید مشکلات حساب را برای یک حساب خاص مرکز فروشگاه فهرست کنید.
GET https://merchantapi.googleapis.com/accounts/v1/accounts/ACCOUNT_ID/issues
درخواست مقایسه URL
| درخواست توضیحات | API محتوا برای خرید | رابط برنامهنویسی کاربردی (API) فروشنده |
|---|---|---|
| مشکلات سطح حساب را برای یک حساب واحد فهرست کنید | GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses/{ACCOUNT_ID} | GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/issues |
| مشکلات سطح حساب را برای همه حسابهای فرعی یک حساب پیشرفته فهرست کنید | GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses | در دسترس نیست. شما باید حسابهای فرعی را بررسی کنید. |
شناسهها
شناسههای حسابها و مشکلات در رابط برنامهنویسی کاربردی فروشنده تغییر کردهاند.
مقایسه شناسهها
| توضیحات شناسه | API محتوا برای خرید | رابط برنامهنویسی کاربردی (API) فروشنده |
|---|---|---|
| شناسه حساب | {MERCHANT_ID} و {ACCOUNT_ID} به عنوان پارامترهای مسیر. | {ACCOUNT_ID} به عنوان پارامتر مسیر در قالب accounts/{ACCOUNT_ID} . |
| شناسه مشکل | فیلد id در بدنه پاسخ (برای مثال، "products-that-enable-dishonest-behavior-hacking-policy" ). | فیلد name در بدنه پاسخ، که نام کامل منبع است (برای مثال، accounts/12345/issues/example-issue-id ). |
روشها
روشهای بازیابی مشکلات حساب در رابط برنامهنویسی کاربردی فروشنده (Merchant API) تجمیع و سادهسازی شدهاند.
مقایسه روشها
| API محتوا برای خرید | رابط برنامهنویسی کاربردی (API) فروشنده | موجودی و نکات |
|---|---|---|
accountstatuses.get | accounts.issues.list | موجود است. برای دریافت مشکلات مربوط به یک حساب کاربری، accounts.issues.list استفاده کنید و شناسه حساب را مشخص کنید. رابط برنامهنویسی کاربردی فروشنده (Merchant API) متد get برای یک مشکل واحد ندارد. |
accountstatuses.list | معادل مستقیمی ندارد. | در دسترس نیست. متد accounts.issues.list در Merchant API فقط مشکلات مربوط به حساب مشخص شده را برمیگرداند، نه زیرحسابهای آن را. برای دریافت مشکلات مربوط به همه زیرحسابها، ابتدا باید accounts.listSubaccounts فراخوانی کنید و سپس accounts.issues.list را برای هر زیرحساب فراخوانی کنید. |
accountstatuses.custombatch | معادل مستقیمی ندارد. | در دسترس نیست. پردازش دستهای برای مشکلات حساب در رابط برنامهنویسی کاربردی فروشنده پشتیبانی نمیشود. شما باید برای هر حساب، فراخوانیهای list جداگانهای انجام دهید. |
تغییرات جزئی فیلدها
فیلدهای موجود در منبع مشکل حساب کاربری بهروزرسانی شدهاند تا ساختار و وضوح بیشتری ارائه دهند.
مقایسه میدانی
| API محتوا برای خرید | رابط برنامهنویسی کاربردی (API) فروشنده | توضیحات |
|---|---|---|
accountLevelIssues (آرایه در AccountStatus ) | accountIssues (آرایه در ListAccountIssuesResponse ) | اکنون Issues یک منبع اختصاصی و سطح بالا هستند، نه یک فیلد تو در تو. |
id (رشته) | name (رشته) | شناسه مسئله اکنون یک نام کامل منبع است، برای مثال accounts/{ACCOUNT_ID}/issues/{ISSUE_ID} . |
title (رشته) | title (رشته) | بدون تغییر. |
detail (رشته) | detail (رشته) | بدون تغییر. |
documentation (رشته) | documentationUri (رشته) | فیلد برای وضوح بیشتر تغییر نام داده شده تا نشان دهد که یک URL است. |
severity (رشته) | severity (شمارشی) | شدت (Severity) اکنون به جای یک رشته، یک شمارش ساختاریافته ( CRITICAL ، ERROR ، SUGGESTION ) است. |
country (رشته)، destination (رشته) | impactedDestinations (پیام تکراری) | تأثیر اکنون به صورت یک لیست ساختار یافته است که مقصد، منطقه و شدت را برای هر منطقه آسیبدیده گروهبندی میکند. فیلد country در پیام Impact با regionCode جایگزین شده است. |
| (موجود نیست) | language_code ، time_zone (پارامترهای درخواست) | پارامترهای جدید در درخواست list ، امکان بومیسازی فیلدهای قابل خواندن توسط انسان مانند title و detail را فراهم میکنند. |