Google מבצעת קריאות לנקודות הקצה של OAuth2 במהלך קישור החשבון. השיחות האלה יכולות להיכשל מסיבות שונות. המידע המפורט הזה מתועד עבור השגיאות האלה. אפשר לעקוב אחריו בדף Logs Explorer בפרויקט שלכם ב-Cloud Console.
סינון לפי שגיאות של קישור חשבונות
בדף Logs Explorer, מגדירים את מסנני השאילתות הבאים ולוחצים על הלחצן Run Query (הפעלת שאילתה):
- משאב: בוחרים באפשרות פרויקט פעולה של Google Assistant אם יצרתם את הפרויקט דרך פעולות ב-Google Console. אחרת, בוחרים באפשרות פרויקט Google.
- שם היומן: בוחרים באפשרות השגיאה קישור חשבון Google.
- חומרה: מוגדרת כ-error. כל הערכים של קישור החשבונות מסווגים כשגיאות.
אפשר גם לסנן לפי תאריך על ידי עדכון טווח הזמן שבחלק העליון של הדף 'סייר היומנים', כפי שמוצג בצילום המסך הבא:
איור 1. מסנני שאילתות של 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 ספציפיים עבור מצבים שונים. הערכים שאתם מחזירים צריכים להתאים למצב הנכון שמופיע במסמכי התיעוד.