הוראות להטמעה של כניסה יחידה (SSO) באמצעות Google בתוספים ל-Classroom מופיעות בדף בנושא כניסה חלקה. במדריך לכניסה חלקה יש גם הפניה לתוכנית בדיקה שאפשר להשתמש בה כדי לוודא שהתוסף פועל בהתאם לשיטות המומלצות לכניסה.
תהליך הכניסה
כדי לצמצם את נקודות החיכוך בתהליך הכניסה למשתמשים, Google Classroom מספקת את פרמטר השאילתה login_hint כשפותחים iframe. login_hint הוא מזהה Google ייחודי של משתמש, והוא מסופק אחרי שהמשתמש נכנס לתוסף שלכם בפעם הראשונה. הפרמטר הזה מספק הקשר לגבי המשתמש שמחובר ל-Google Classroom. בדף המדריך בנושא פרמטרים של כניסה מופיע הסבר מפורט יותר על פרמטרים של שאילתות.
אם פרמטר השאילתה login_hint של המשתמש הנוכחי ב-Google Classroom לא תואם לאף משתמש מחובר בתוסף, צריך להציג תיבת דו-שיח לכניסה לחשבון Google. הכפתור חייב לעמוד בדרישות הנחיות המיתוג של Google. אם המשתמש כבר מחובר לחשבון, לא אמורה להופיע לו בקשה להתחבר שוב.
איור 1. תהליך הכניסה לחשבון כשמשתמש מפעיל את התוסף בפעם הראשונה.
[null,null,["עדכון אחרון: 2025-08-29 (שעון UTC)."],[],[],null,["# Sign in\n\nGoogle Classroom add-ons **must** use Google single sign-on (SSO) to identify\nand authenticate users.\n\nSee [Google Identity's OpenID Connect Guide](https://developers.google.com/identity/protocols/oauth2/openid-connect) for more information on SSO. We\nalso recommend referencing Google's official documentation on user sign-up and\nsign-in for [automatic sign in](https://developers.google.com/identity/gsi/web) and [Sign-In Branding Guidelines](https://developers.google.com/identity/branding-guidelines).\n\nSee the [frictionless sign-in page](/workspace/classroom/add-ons/developer-guides/frictionless-signin) for implementation guidance for Google SSO\nin Classroom add-ons. The frictionless sign-in guide also refers\nto the [test plan](/static/workspace/classroom/assets/classroom_add_ons_test_plan.pdf) that can be used to ensure your add-on is\nfollowing sign-in best practices.\n\nSign in flow\n------------\n\nTo reduce sign-in friction for users, Google Classroom provides the\n`login_hint` query parameter when an iframe is opened. `login_hint` is a user's\nunique Google ID, and is provided *after* the user has signed into your add-on\nfor the first time. This parameter provides context on the user that's signed\ninto Google Classroom. See our [sign-in parameters guide page](/workspace/classroom/add-ons/developer-guides/iframes#sign-in_related_parameters) for a more\ndetailed discussion of these query parameters.\n\nYou must display a Google sign-in dialog if the `login_hint` query parameter of\nthe current Google Classroom user doesn't match any signed-in user of the\nadd-on. The button must adhere to [Google's branding guidelines](https://developers.google.com/identity/branding-guidelines). If the user is\nalready signed in, they shouldn't be prompted to sign-in again.\n\n**Figure 1.** Sign in flow when a user initially launches\nyour add-on.\n| **Important:** The sign in button should only be seen when the add-on doesn't have a signed in user to compare against the `login_hint` query parameter. The sign in button is unnecessary if the add-on matches the signed in user using the value of `login_hint`; in this case, the add-on should keep the user signed in."]]
איור 1. תהליך הכניסה לחשבון כשמשתמש מפעיל את התוסף בפעם הראשונה.