כניסה קלה

מכיוון שחוויית הכניסה היא האינטראקציה הראשונה של משתמש עם חשוב שהם יוכלו להשלים את התהליך בצורה חלקה ככל האפשר. כדאי לקרוא את הקטעים הבאים כדי להכיר את ממשקי API לכניסה, פרמטר שאילתה שקשור לכניסה, איך לטפל בחוסמי חלונות קופצים, ותוכנית בדיקה שבה תוכלו להשתמש במהלך הפיתוח, כדי לוודא שאתם שיטות מומלצות.

פרטי הטמעת SSO

פרוטוקול OAuth 2.0 של Google תואם להרבה פרוטוקולי OAuth 2.0 מקבצים. אנחנו מאוד ממליצים להטמיע הרשאה בצד השרת בתור זוהי אפשרות האבטחה הגבוהה ביותר, והיא תומכת בשימוש בשאילתת iframe .

כדאי לעיין בהנחיות הטכניות המופיעות באתר של Google Identity אם הטמעת כניסה באמצעות חשבון Google. חשוב לפעול בהתאם למיתוג של כניסה באמצעות חשבון Google הנחיות. קובצי שרטוט, SVG ו-EPS ניתנים להורדה.

בדיקות כניסה

כדאי להשתמש בתוכנית הבדיקה של התוספים כדי לוודא שהתוסף עומד בדרישות של על הסטנדרטים הנדרשים ועל היכולת לטפל במקרי קצה ידועים לפני ששולחים את לבדיקה. הבדיקות האלה משקפות במידה רבה את התוסף של Classroom רשימת משימות מפורטות, כולל הוראות מפורטות אם התוסף עומד בדרישות האלה. אלו אותן בדיקות שמולוות האפליקציה נבדקת במהלך הפרסום.

פרמטרים של שאילתה לכניסה לחשבון

Google Classroom מספק את פרמטר השאילתה login_hint כדי לעזור כניסה חוזרת. מידע נוסף זמין בקטע 'פרמטרים שקשורים לכניסה' ב-iframe לקבלת מידע נוסף על הפרמטרים של שאילתה. ניתן למצוא את הקוד לדוגמה ב- ההדרכה המפורטת בנושא ביקורים חוזרים בהדרכה המפורטת שלנו למפתחים.

ניהול של חוסמי חלונות קופצים

הכניסה לתוסף מתבצעת בקלות בחלון של תיבת הדו-שיח לכניסה. הזה מציג את המסך של בורר החשבונות ומאפשר למשתמש להעניק OAuth הרשאות. חוסם החלונות הקופצים של משתמש הקצה עשוי למנוע ממנו להשלים את תהליך הכניסה.

איור 1. דוגמה למסך של בורר חשבונות.

כדי לפתור את הבעיה, צריך לספק למשתמש הקצה לחצן שניתן לעקוף אותו חוסם החלונות הקופצים. האינטראקציה הזו מאפשרת להציג את תיבת הדו-שיח לכניסה כדי שמשתמש הקצה יוכל להמשיך בתהליך הכניסה. ודאו שהלחצן צריך לעמוד בהנחיות המיתוג לכניסה.

עליך לפעול לפי ההדרכה המפורטת בכניסה לחשבון בהדרכה המפורטת שלנו למפתחים כדי להטמיע לחצן כניסה ממותג של Google שאפשר ללחוץ עליו כדי להפעיל את תיבת הדו-שיח לכניסה.

התחברות לכמה נמענים

דפדפן עם כמה חשבונות שמחוברים בו-זמנית עלול לשבש את תהליך המשתמש של התוסף. משתמשי הקצה יכולים לצאת מכל חשבונות Google ב- הדפדפן הנוכחי או לפתוח את Classroom בחלון פרטי ב-Chrome. לפני שתיכנסו באמצעות החשבון הנכון ותנסה שוב את הפעולה.

אם משתמש שגוי נכנס לתוסף בגלל בעיה שקשורה להתחברות לכמה נמענים, הקריאות ל-API לתוספים של Classroom עלולות להיכשל שגיאה InvalidAddOnToken. אם קיבלת שגיאה כזו, עליך להנחות אותך המשתמש יצטרך לצאת מכל החשבונות האחרים בדפדפן או לפתוח צריך להשתמש ב-Classroom בחלון פרטי של Chrome.