Google در طول فرآیند پیوند حساب با نقاط پایانی OAuth2 شما تماس می گیرد. این تماس ها ممکن است به دلایل مختلف با شکست مواجه شوند. اطلاعات دقیق برای این خطاها ثبت می شود و می توانید آنها را در صفحه Logs Explorer پروژه کنسول ابری خود نظارت کنید.
فیلتر کردن خطاهای پیوند حساب
در صفحه Logs Explorer ، فیلترهای پرس و جو را به صورت زیر تنظیم کنید و روی دکمه Run Query کلیک کنید:
- منبع : اگر پروژه را از طریق Actions on Google Console ایجاد کرده اید، Google Assistant Action Project را انتخاب کنید. در غیر این صورت گزینه Google Project را انتخاب کنید.
- Log Name : گزینه Google Account Linking Error را انتخاب کنید.
- شدت : روی خطا تنظیم شود . تمام ورودی های پیوند حساب به عنوان خطا طبقه بندی می شوند.
همانطور که در تصویر زیر نشان داده شده است، می‌توانید با به‌روزرسانی محدوده زمانی در بالای صفحه Logs Explorer، بر اساس تاریخ فیلتر کنید:
شکل 1 . لاگ فیلترهای پرس و جو اکسپلورر
می توانید اطلاعات بیشتری در مورد نحوه استفاده از Logs Explorer در مستندات Logs Explorer بیابید.
محتوای داده های خطا
داده‌های خطای پیوند حساب در ویژگی jsonPayload ورودی خطا موجود است. داده ها شامل فیلدهای زیر است:
-
@type(String): همیشه رویtype.googleapis.com/google.identity.accountlinking.type.AccountLinkingErrorتنظیم شود. -
step(String): مرحله پیوندی که در آن خطا رخ داده است. یکی از این مقادیر را تنظیم کنید:-
ACCOUNT_LINKING_STEP_UNDEFINED: یک مرحله تعریف نشده. -
AUTH_CODE_EXCHANGE: مرحله مبادله کد اعتبار برای دسترسی یا رفرش توکن. -
REFRESH_ACCESS_TOKEN: مرحله به روز رسانی یک نشانه دسترسی. -
TOKEN_REVOCATION: مرحله ابطال یک نشانه. -
USERINFO: مرحله واکشی اطلاعات کاربر با یک نشانه دسترسی. -
ASSERTION: مرحله ایجاد پیوند با ادعا.
-
-
response(String, optional): یک پاسخ HTTP را نشان می دهد:-
status: وضعیت پاسخ HTTP. -
body: شرح خطا و رشته خطا.
-
-
request(String, optional): یک درخواست HTTP را نشان می‌دهد و شامل پارامترهای درخواست HTTP زیر است: متد، بدنه، URI و هدرها.
فیلدهای request و response اختیاری هستند زیرا گاهی اوقات به 2 ورودی مختلف در نمایشگر گزارش تفکیک می شوند.
هنگام پیاده‌سازی سرور OAuth پیوند حساب Google خود و سرور OAuth پیوند حساب Google ساده ، باید از کدهای پاسخ HTTP خاصی برای حالت‌های مختلف استفاده کنید. مقادیری که برمی گردانید باید با وضعیت صحیح فهرست شده در مستندات مطابقت داشته باشد.