مهاجرت از وضعیت حساب به مسائل حساب

روش بازیابی مشکلات سطح حساب که می تواند بر محصولات و سلامت حساب شما تأثیر بگذارد تغییر کرده است. در مقایسه با منبع accountstatuses در Content API برای خرید، Merchant API یک منبع اختصاصی AccountIssue معرفی می کند که اطلاعات ساختاریافته و دقیق تری را ارائه می دهد.

برای اطلاعات بیشتر در مورد نحوه استفاده از ویژگی جدید، راهنمای مشاهده مشکلات حساب را ببینید.

تفاوت های کلیدی

در اینجا پیشرفت‌ها و تفاوت‌های کلیدی در منبع 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 برای خرید می شود.
  • پشتیبانی محلی‌سازی: روش accounts.issues.list به شما امکان می‌دهد یک language_code برای دریافت جزئیات موضوع، مانند عنوان و توضیحات، به زبان دلخواه خود تعیین کنید. این امکان در Content API برای خرید وجود نداشت.
  • رفتار حساب پیشرفته: هنگامی که با accounts.issues.list در یک حساب پیشرفته تماس می‌گیرید، فقط مشکلاتی را که مستقیماً به آن حساب پیشرفته اعمال می‌شود برمی‌گرداند. مسائل مربوط به هیچ یک از حساب های فرعی خود را بر نمی گرداند. در Content API for Shopping، روش accountstatuses.list وضعیت همه حساب‌های فرعی را برمی‌گرداند. برای دریافت مشکلات برای همه حساب‌های فرعی در Merchant API، باید با accounts.listSubaccounts تماس بگیرید و سپس accounts.issues.list برای هر حساب فرعی به صورت جداگانه تماس بگیرید.

درخواست ها

در Merchant API، می‌توانید مشکلات حساب را برای یک حساب Merchant Center خاص فهرست کنید.

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/ACCOUNT_ID/issues

درخواست مقایسه URL

درخواست توضیحات Content API برای خرید Merchant API
مشکلات سطح حساب را برای یک حساب فهرست کنید GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses/{ACCOUNT_ID} GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/issues
مسائل مربوط به سطح حساب را برای همه حساب‌های فرعی یک حساب پیشرفته فهرست کنید GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses در دسترس نیست. باید از طریق حساب های فرعی تکرار کنید.

شناسه ها

شناسه‌های حساب‌ها و مشکلات در Merchant API تغییر کرده‌اند.

مقایسه شناسه

شرح شناسه Content API برای خرید Merchant 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 ادغام و ساده‌سازی شده‌اند.

مقایسه روش

Content API برای خرید Merchant 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 بدون معادل مستقیم در دسترس نیست. پردازش دسته‌ای برای مشکلات حساب در Merchant API پشتیبانی نمی‌شود. باید برای هر حساب تماس های list جداگانه برقرار کنید.

تغییرات میدان دقیق

فیلدهای موجود در منبع مشکل حساب به روز شده اند تا ساختار و وضوح بیشتری ارائه دهند.

مقایسه میدانی

Content API برای خرید Merchant API توضیحات
accountLevelIssues (آرایه در AccountStatus ) accountIssues (آرایه در ListAccountIssuesResponse ) مسائل اکنون یک منبع اختصاصی و سطح بالا هستند، نه یک فیلد تودرتو.
id (رشته) name (رشته) شناسه مشکل اکنون یک نام کامل منبع است، برای مثال accounts/{ACCOUNT_ID}/issues/{ISSUE_ID} .
title (رشته) title (رشته) بدون تغییر.
detail (رشته) detail (رشته) بدون تغییر.
documentation (رشته) documentationUri (رشته) نام فیلد برای وضوح تغییر نام داده شد تا نشان دهد که یک URL است.
severity (رشته) severity (تعدادی) اکنون شدت به‌جای رشته، یک عدد ساختاریافته ( CRITICAL ، ERROR ، SUGGESTION ) است.
country (رشته)، destination (رشته) impactedDestinations (پیام تکراری) Impact اکنون در یک لیست ساختار یافته است که مقصد، منطقه و شدت را برای هر منطقه آسیب دیده گروه بندی می کند. فیلد country با regionCode در پیام Impact جایگزین می شود.
(در دسترس نیست) language_code , time_zone (پارامترهای درخواست) پارامترهای جدید در درخواست list امکان محلی سازی فیلدهای قابل خواندن توسط انسان مانند title و detail را فراهم می کند.
قبلی
Overview
بعدی
Migrate user and access management