Weitere Informationen Im Leitfaden für die reibungslose Anmeldung wird auch auf den Testplan verwiesen, mit dem Sie sicherstellen können, dass Ihr Add-on den Best Practices für die Anmeldung entspricht.
Anmeldevorgang
Um die Anmeldung für Nutzer zu vereinfachen, stellt Google Classroom den Abfrageparameter login_hint bereit, wenn ein iFrame geöffnet wird. login_hint ist die eindeutige Google-ID eines Nutzers und wird nach der ersten Anmeldung des Nutzers in Ihrem Add-on bereitgestellt. Dieser Parameter enthält Kontextinformationen zum Nutzer, der in Google Classroom angemeldet ist. Eine detailliertere Beschreibung dieser Abfrageparameter finden Sie auf unserer Seite mit Anmeldeparametern.
Sie müssen einen Google-Anmeldedialog anzeigen, wenn der login_hint-Suchparameter des aktuellen Google Classroom-Nutzers mit keinem angemeldeten Nutzer des Add-ons übereinstimmt. Die Schaltfläche muss den Branding-Richtlinien von Google entsprechen. Wenn der Nutzer bereits angemeldet ist, sollte er nicht noch einmal zur Anmeldung aufgefordert werden.
Abbildung 1: Anmeldevorgang, wenn ein Nutzer Ihr Add-on zum ersten Mal startet.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 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."]]
Abbildung 1: Anmeldevorgang, wenn ein Nutzer Ihr Add-on zum ersten Mal startet.