Les modules complémentaires Google Classroom sont désormais disponibles pour tous les développeurs. Pour en savoir plus, consultez la documentation sur les modules complémentaires.
Consultez la page sur la connexion fluide pour obtenir des conseils sur l'implémentation de l'authentification unique Google dans les modules complémentaires Classroom. Le guide de connexion fluide fait également référence au plan de test qui peut être utilisé pour s'assurer que votre module complémentaire respecte les bonnes pratiques de connexion.
Processus de connexion
Pour réduire les difficultés de connexion des utilisateurs, Google Classroom fournit le paramètre de requête login_hint lorsqu'un iFrame est ouvert. login_hint est l'ID Google unique d'un utilisateur. Il est fourni après que l'utilisateur s'est connecté à votre module complémentaire pour la première fois. Ce paramètre fournit des informations contextuelles sur l'utilisateur connecté à Google Classroom. Pour en savoir plus sur ces paramètres de requête, consultez notre guide sur les paramètres de connexion.
Vous devez afficher une boîte de dialogue de connexion Google si le paramètre de requête login_hint de l'utilisateur Google Classroom actuel ne correspond à aucun utilisateur connecté du module complémentaire. Le bouton doit respecter les consignes relatives à la marque de Google. Si l'utilisateur est déjà connecté, il ne doit pas être invité à se reconnecter.
Figure 1. Procédure de connexion lorsqu'un utilisateur lance votre module complémentaire pour la première fois.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/29 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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."]]
Figure 1. Procédure de connexion lorsqu'un utilisateur lance votre module complémentaire pour la première fois.