روش بازیابی مشکلات سطح حساب که می‌تواند بر محصولات و سلامت حساب شما تأثیر بگذارد تغییر کرده است. درمقایسه با منبع accountstatuses در
Content API for Shopping، Merchant API منبع اختصاصی AccountIssue را معرفی می‌کند
که اطلاعات ساختاریافته‌تر و دقیق‌تری ارائه می‌دهد.
برای اطلاعات بیشتر درباره نحوه استفاده از ویژگی جدید، راهنمای مشاهده مشکلات حساب را ببینید.
توجه: در Merchant API، مشکلات سطح حساب و وضعیت‌های محصول انبوه
ازهم جدا شده‌اند. همچنین راهنمای ما را برای انتقال از accountstatuses به
وضعیت‌های محصول انبوه مرور کنید.
تفاوت‌های اصلی
در اینجا بهبودها و تفاوت‌های کلیدی در منبع Merchant API AccountIssue
آورده شده است:
- منبع اختصاصی: مشکلات حساب منبع خاص خود را دارند. در Content
API for Shopping، مشکلات سطح حساب فیلدی تودرتو در
منبع عمومی
AccountStatusبود. با Merchant API می‌توانید آن‌ها را مستقیماً بااستفاده از روشaccounts.issues.listفهرست کنید. - داده‌های تأثیر ساختاریافته: منبع
AccountIssueفیلدimpactedDestinationsدقیقی ارائه می‌دهد. این فیلد تفکیک واضحی از تأثیر مشکل ارائه می‌دهد، ازجمله مقصد (برای مثال، آگهی‌های Shopping)، منطقه خاص، و شدت مشکل در آن منطقه. - شدت به‌عنوان enum: فیلد
severityاکنون یک enum است (با مقادیری مانندCRITICAL،ERROR،SUGGESTION)، که پردازش برنامه‌ای آن را درمقایسه با مقادیر مبتنی بر رشته در Content API for Shopping آسان‌تر می‌کند. - شناسه‌های استانداردشده: هر مشکل حساب دارای یک منبع کامل و منحصربه‌فرد
nameدر قالبaccounts/{ACCOUNT_ID}/issues/{ISSUE_ID}است. این رویکرد استانداردشده جایگزین رشتهidاز Content API for Shopping می‌شود. - پشتیبانی از بومی‌سازی: روش
accounts.issues.listبه شما امکان می‌دهدlanguage_codeرا برای دریافت جزئیات مشکل، مانند عنوان و شرح، به زبان ترجیحی‌تان مشخص کنید. این کار در Content API for Shopping امکان‌پذیر نبود. - رفتار حساب پیشرفته: وقتی
accounts.issues.listرا در حساب پیشرفته فراخوانی می‌کنید، فقط مشکلاتی را برمی‌گرداند که مستقیماً به آن حساب پیشرفته مربوط می‌شود. مشکلات هیچ‌کدام از حساب‌های فرعی آن را برنمی‌گرداند. در «میانای برنامه‌سازی کاربردی محتوا برای خرید»، روشaccountstatuses.listوضعیت‌های همه حساب‌های فرعی را برمی‌گرداند. برای دریافت مشکلات همه حساب‌های فرعی در Merchant API، بایدaccounts.listSubaccountsرا فراخوانی کنید و سپسaccounts.issues.listرا برای هر حساب فرعی به‌طور جداگانه فراخوانی کنید.
درخواست‌ها
در Merchant API، می‌توانید مشکلات حساب را برای حساب Merchant Center خاصی فهرست کنید.
GET https://merchantapi.googleapis.com/accounts/v1/accounts/ACCOUNT_ID/issues
مقایسه نشانی وب درخواست
| شرح درخواست | Content API for Shopping | میانای برنامه‌سازی کاربردی فروشنده |
|---|---|---|
| فهرست کردن مشکلات سطح حساب برای یک حساب | 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 |
دردسترس نیست. باید زیرحساب‌ها را تکرار کنید. |
شناسه‌ها
شناسه‌های حساب‌ها و مشکلات در Merchant API تغییر کرده است.
مقایسه شناسه
| شرح شناسه | Content API for Shopping | میانای برنامه‌سازی کاربردی فروشنده |
|---|---|---|
| شناسه حساب | {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 ادغام و ساده‌سازی شده است.
مقایسه روش‌ها
| Content API for Shopping | میانای برنامه‌سازی کاربردی فروشنده | دردسترس بودن و نکات |
|---|---|---|
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 |
معادل مستقیم ندارد. | دردسترس نیست. پردازش دسته‌ای برای مشکلات حساب در Merchant API پشتیبانی نمی‌شود. باید برای هر حساب تماس‌های list جداگانه برقرار کنید. |
تغییرات دقیق فیلد
فیلدهای درون منبع مشکل حساب به‌روز شده‌اند تا ساختار و شفافیت بیشتری ارائه دهند.
مقایسه فیلد
| Content API for Shopping | میانای برنامه‌سازی کاربردی فروشنده | شرح |
|---|---|---|
accountLevelIssues (آرایه در AccountStatus) |
accountIssues (آرایه در ListAccountIssuesResponse) |
مشکلات اکنون یک منبع اختصاصی و سطح بالا هستند، نه یک فیلد تودرتو. |
id (رشته) |
name (رشته) |
شناسه مشکل اکنون نام کامل منبع است، برای مثال accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}. |
title (رشته) |
title (رشته) |
تغییری ایجاد نشد. |
detail (رشته) |
detail (رشته) |
تغییری ایجاد نشد. |
documentation (رشته) |
documentationUri (رشته) |
فیلد برای شفافیت بیشتر تغییر نام داده شد تا نشان دهد که نشانی وب است. |
severity (رشته) |
severity (enum) |
«شدت» اکنون به‌جای رشته، یک شمارش ساختاریافته (CRITICAL، ERROR، SUGGESTION) است. |
country (رشته)، destination (رشته) |
impactedDestinations (پیام تکراری) |
تأثیر اکنون به‌صورت فهرست ساختاریافته است و مقصد، منطقه، و شدت را برای هر منطقه تحت‌تأثیر گروه‌بندی می‌کند. فیلد country با regionCode در پیام Impact جایگزین می‌شود. |
| (دردسترس نیست) | language_code، time_zone (پارامترهای درخواست) |
پارامترهای جدید در درخواست list امکان بومی‌سازی فیلدهای قابل‌خواندن برای انسان مثل title و detail را فراهم می‌کند. |