Google Classroom-Add‑ons müssen die Einmalanmeldung (Single Sign-On, SSO) von Google verwenden, um Nutzer zu identifizieren und zu authentifizieren.
Weitere Informationen zur Einmalanmeldung finden Sie im OpenID Connect-Leitfaden von Google Identity. Wir empfehlen außerdem, die offizielle Google-Dokumentation zur Nutzerregistrierung und ‑anmeldung für die automatische Anmeldung und die Richtlinien für das Branding bei der Anmeldung zu lesen.
Auf der Seite zur reibungslosen Anmeldung finden Sie eine Implementierungsanleitung für die Google-Einmalanmeldung in Classroom-Add‑ons. Im Leitfaden zur reibungslosen Anmeldung wird auch auf den Testplan verwiesen, mit dem Sie sicherstellen können, dass Ihr Add‑on die Best Practices für die Anmeldung einhält.
Anmeldeablauf
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 nachdem der Nutzer sich zum ersten Mal in Ihrem Add‑on angemeldet hat bereitgestellt. Dieser Parameter liefert Kontext zum Nutzer, der in Google Classroom angemeldet ist. Eine detailliertere Erläuterung dieser Abfrageparameter finden Sie auf unserer Hilfeseite zu Anmeldeparametern.
Sie müssen ein Google-Anmeldedialogfeld anzeigen, wenn der Abfrageparameter login_hint des aktuellen Google Classroom-Nutzers mit keinem angemeldeten Nutzer des Add‑ons übereinstimmt. Die Schaltfläche muss den Google-Markenrichtlinien entsprechen. Wenn der Nutzer bereits angemeldet ist, sollte er nicht aufgefordert werden, sich noch einmal anzumelden.
Abbildung 1. Anmeldeablauf, wenn ein Nutzer Ihr Add‑on zum ersten Mal startet.