Consulta la pagina di accesso senza problemi per indicazioni sull'implementazione di Google SSO
nei componenti aggiuntivi di Classroom. La guida all'accesso senza problemi fa riferimento anche
al piano di test che può essere utilizzato per assicurarsi che il componente aggiuntivo
segua le best practice di accesso.
Flusso di accesso
Per ridurre l'attrito di accesso per gli utenti, Google Classroom fornisce il
parametro di query login_hint quando viene aperto un iframe. login_hint è l'ID Google
univoco di un utente e viene fornito dopo che l'utente ha eseguito l'accesso al tuo componente aggiuntivo
per la prima volta. Questo parametro fornisce il contesto dell'utente che ha eseguito
l'accesso a Google Classroom. Per una discussione più dettagliata di questi parametri di query, consulta la nostra pagina della guida ai parametri di accesso.
Devi visualizzare una finestra di dialogo di accesso a Google se il parametro di query login_hint dell'utente di Google Classroom corrente non corrisponde a nessun utente che ha eseguito l'accesso al componente aggiuntivo. Il pulsante deve rispettare le linee guida per il branding di Google. Se l'utente ha
già eseguito l'accesso, non dovrebbe essere invitato a farlo di nuovo.
Figura 1. Flusso di accesso quando un utente avvia inizialmente
il tuo componente aggiuntivo.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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."]]
Figura 1. Flusso di accesso quando un utente avvia inizialmente
il tuo componente aggiuntivo.