Poiché l'esperienza di accesso è la prima interazione che un utente potrebbe avere con il tuo componente aggiuntivo, è importante che possa completare la procedura nel modo più semplice possibile. Leggi le sezioni di seguito per acquisire familiarità con le varie API di accesso, il parametro di query correlato all'accesso, come gestire i bloccanti popup e un piano di test che puoi utilizzare durante lo sviluppo per assicurarti di seguire le best practice.
Dettagli di implementazione SSO
OAuth 2.0 di Google è compatibile con molti stack OAuth 2.0. Ti consigliamo vivamente di implementare l'autorizzazione lato server, in quanto è l'opzione di sicurezza più elevata e supporta l'utilizzo dei parametri di query iframe.
Quando implementi Accedi con Google, consulta le indicazioni tecniche fornite nel sito web di Google Identity quando Assicurati di seguire le linee guida per il branding di Accedi con Google. I file Sketch, SVG ed EPS sono disponibili per il download.
Test di accesso
Utilizza il piano di test dei componenti aggiuntivi per verificare che il tuo componente aggiuntivo soddisfi gli standard richiesti e sia in grado di gestire i casi limite noti prima di inviarlo per la revisione. Questi test rispecchiano da vicino la checklist dei requisiti dei componenti aggiuntivi di Classroom e forniscono istruzioni passo passo su come verificare se il tuo componente aggiuntivo soddisfa questi requisiti. Questi sono gli stessi test a cui viene sottoposta la tua applicazione durante la pubblicazione.
Parametri di query di accesso
Google Classroom fornisce il parametro di query login_hint per facilitare l'accesso ripetuto. Per ulteriori informazioni, consulta la sezione relativa ai parametri di accesso della pagina dei parametri di query iframe. Il codice campione è disponibile in
nella procedura dettagliata per la gestione delle visite ripetute delle nostre procedure dettagliate per gli sviluppatori.
Gestire i bloccanti popup
L'accesso al componente aggiuntivo è facilitato dalla finestra di dialogo di accesso. Questa finestra mostra la schermata di selezione dell'account e consente all'utente di concedere le autorizzazioni OAuth. Il blocco dei popup di un utente finale potrebbe impedirgli di completare la procedura di accesso.
Figura 1. Un esempio di schermata di selezione dell'account.
Per risolvere il problema, fornisci all'utente finale un pulsante su cui fare clic per ignorare il blocco dei popup. Questa interazione consente di visualizzare la finestra di dialogo di accesso in modo che l'utente finale possa continuare la procedura di accesso. Assicurati che il pulsante fornito rispetti le linee guida per il branding di accesso.
Accessi simultanei
Un browser con più account con accesso simultaneo potrebbe interrompere il flusso utente del componente aggiuntivo. Gli utenti finali possono disconnettersi da tutti gli Account Google nel browser corrente oppure aprire Classroom in una finestra di navigazione in incognito di Chrome prima di accedere con l'account corretto e riprovare l'operazione.
Se un utente errato ha eseguito l'accesso al componente aggiuntivo a causa del problema di accesso simultaneo,
le chiamate all'API dei componenti aggiuntivi di Classroom potrebbero non riuscire e generare un
InvalidAddOnToken errore. Se ricevi questo errore, devi chiedere all'utente di disconnettersi da tutti gli altri account nel browser o di aprire Classroom in una finestra di navigazione in incognito di Chrome.