תהליך הכניסה הוא האינטראקציה הראשונה של המשתמש עם התוסף, ולכן חשוב שהוא יוכל להשלים את התהליך בצורה חלקה ככל האפשר. בקטעים הבאים מוסבר על ממשקי ה-API השונים לכניסה לחשבון, על פרמטר השאילתה שקשור לכניסה לחשבון, על אופן הטיפול בחוסמי חלונות קופצים ועל תוכנית בדיקה שתוכלו להשתמש בה במהלך הפיתוח כדי לוודא שאתם פועלים לפי שיטות מומלצות.
פרטי הטמעה של SSO
OAuth 2.0 של Google תואם למערכות רבות של OAuth 2.0. מומלץ מאוד להטמיע הרשאה בצד השרת, כי זו האפשרות הכי מאובטחת והיא תומכת בשימוש בפרמטרים של שאילתת iframe.
כשמטמיעים את התכונה 'כניסה באמצעות חשבון Google', מומלץ להיעזר בהנחיות הטכניות שמפורטות באתר Google Identity. חשוב לפעול לפי ההנחיות של Google בנושא מיתוג של כניסה. אפשר להוריד קובצי Sketch, SVG ו-EPS.
בדיקות כניסה
כדאי להשתמש בתוכנית הבדיקה של התוספים כדי לוודא שהתוסף עומד בתקנים הנדרשים ויכול לטפל במקרים קיצוניים מוכרים לפני ששולחים את התוסף לבדיקה. הבדיקות האלה משקפות באופן מדויק את רשימת הדרישות לתוספים ל-Classroom, ומספקות הוראות מפורטות לבדיקה אם התוסף עומד בדרישות האלה. אלה אותן הבדיקות שהאפליקציה שלכם עוברת במהלך הפרסום.
פרמטרים של שאילתה לכניסה
Google Classroom מספקת את פרמטר השאילתה login_hint כדי להקל על כניסה חוזרת. מידע נוסף זמין בקטע בנושא פרמטרים שקשורים לכניסה בדף פרמטרים של שאילתות iframe. דוגמאות לקוד אפשר למצוא במדריך המפורט לטיפול בביקורים חוזרים מתוך המדריכים המפורטים למפתחים.
ניהול חסימת חלונות קופצים
כדי להיכנס לתוסף, משתמשים בחלון הדו-שיח של הכניסה. בחלון הזה מוצג מסך בחירת החשבון, והמשתמש יכול לתת הרשאות OAuth. יכול להיות שתוכנה לחסימת חלונות קופצים אצל משתמש קצה תמנע ממנו להשלים את תהליך הכניסה.
איור 1. דוגמה למסך לבחירת חשבון.
כדי לפתור את הבעיה, צריך לספק למשתמש הקצה כפתור שאפשר ללחוץ עליו כדי לעקוף את חוסם החלונות הקופצים. האינטראקציה הזו מאפשרת להציג את תיבת הדו-שיח של הכניסה לחשבון, כדי שמשתמש הקצה יוכל להמשיך בתהליך הכניסה. מוודאים שהלחצן שאתם מספקים עומד בהנחיות למיתוג של כניסה לחשבון.
כדי להטמיע לחצן כניסה עם מיתוג Google שאפשר ללחוץ עליו כדי להפעיל את תיבת הדו-שיח לכניסה, פועלים לפי ההוראות לכניסה במדריכים למפתחים.
כניסה עם מספר חשבונות
דפדפן שמחוברים אליו כמה חשבונות בו-זמנית עלול לשבש את תהליך השימוש בתוסף. משתמשי הקצה יכולים לצאת מכל חשבונות Google בדפדפן הנוכחי או לפתוח את Classroom בחלון אנונימי ב-Chrome, ואז להיכנס עם החשבון הנכון ולנסות שוב לבצע את הפעולה.
אם משתמש לא נכון מחובר לתוסף בגלל בעיית הכניסה המרובה, יכול להיות שהקריאות שלכם ל-API של תוספי Classroom ייכשלו עם שגיאה InvalidAddOnToken. אם הודעת השגיאה הזו מופיעה, צריך להנחות את המשתמש להתנתק מכל החשבונות האחרים בדפדפן או לפתוח את Classroom בחלון פרטי של Chrome.