Google מבצעת קריאות לנקודות הקצה של OAuth2 במהלך תהליך קישור החשבון. הקריאות האלה עלולות להיכשל מסיבות שונות. מידע מפורט נרשם עבור השגיאות האלה, ואפשר לעקוב אחריהן בדף Logs Explorer של הפרויקט במסוף Cloud.
סינון לפי שגיאות שקשורות לקישור חשבון
בדף Logs Explorer, מגדירים את מסנני השאילתות כך: ולוחצים על הלחצן Run Query:
- משאב: בוחרים באפשרות Google Assistant Action Project אם יצרתם את הפרויקט דרך Actions on Google Console. אם לא, בוחרים באפשרות Google Project.
- Log Name: בוחרים באפשרות השגיאה Google Account Linking.
- Severity: מגדירים את הערך error. כל הרשומות של קישור חשבונות מסווגות כשגיאות.
אפשר גם לסנן לפי תאריך על ידי עדכון טווח הזמן בחלק העליון של הדף Logs Explorer, כפי שמוצג בצילום המסך הבא:
איור 1. מסנני שאילתות ב-Logs Explorer
מידע נוסף על השימוש ב-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: השלב ליצירת קישור באמצעות טענת נכוֹנוּת (assertion).
response(String, optional): מייצג תגובת HTTP:status: הסטטוס של תגובת ה-HTTP.body: תיאור השגיאה ומחרוזת השגיאה.
request(String, optional): מייצג בקשת HTTP ומכיל את הפרמטרים הבאים של בקשת ה-HTTP: method, body, URI וכותרות.
השדות request ו-response הם אופציונליים כי לפעמים הם מופרדים לשתי רשומות שונות בחלון הצפייה ביומן.
כשמטמיעים את שרת ה-OAuth לקישור חשבון Google ואת שרת ה-OAuth לקישור חשבון Google משופר, צריך להשתמש בקודים ספציפיים של תגובות HTTP למצבים שונים. הערכים שתחזירו חייבים להתאים למצב הנכון שמופיע במסמכים.