Poiché l'esperienza di accesso è la prima interazione che un utente può avere con il componente aggiuntivo, è importante che gli utenti siano in grado di completare la procedura nel modo più agevole possibile. Leggi le sezioni seguenti per acquisire familiarità con varie API di accesso, i parametri di query relativi all'accesso, come gestire i blocchi popup e un piano di test che puoi utilizzare durante lo sviluppo per assicurarti di seguire le best practice.
Dettagli implementazione SSO
OAuth 2.0 di Google è compatibile con molti stack OAuth 2.0. Ti consigliamo vivamente di implementare l'autorizzazione lato server poiché è l'opzione di sicurezza più elevata e supporta l'uso dei parametri di query degli iframe.
Fai riferimento alle indicazioni tecniche fornite sul sito web di Google Identity quando implementi Accedi con Google. Assicurati di rispettare le linee guida per il branding di Accedi con Google. I file Sketch, SVG ed EPS vengono forniti per il download.
Test dell'accesso
Utilizza il piano di test dei componenti aggiuntivi per verificare che quest'ultimo soddisfi gli standard richiesti e in grado di gestire i casi limite noti prima di inviarlo per la revisione. Questi test sono molto simili all'elenco di controllo dei requisiti del componente aggiuntivo di Classroom e forniscono istruzioni dettagliate su come verificare se il componente aggiuntivo soddisfa questi requisiti. Si tratta degli stessi test rispetto ai quali l'applicazione viene testata durante la pubblicazione.
Parametri di query di accesso
Google Classroom fornisce il parametro di query login_hint per facilitare
gli accessi ripetuti. Per ulteriori informazioni, consulta la sezione dei parametri relativi all'accesso della pagina dei parametri di query dell'iframe. Il codice campione è disponibile nella procedura dettagliata per gestire le visite ripetute delle nostre procedure dettagliate per sviluppatori.
Gestisci i blocchi popup
L'accesso al componente aggiuntivo è facilitato dalla finestra di dialogo di accesso. Questa finestra mostra la schermata del selettore account e consente all'utente di concedere le autorizzazioni OAuth. Il blocco popup di un utente finale potrebbe impedirgli di completare il flusso di accesso.
Figura 1. Un esempio di schermata del selettore account.
Per risolvere il problema, fornisci all'utente finale un pulsante su cui fare clic per bypassare il blocco popup. Questa interazione consente di visualizzare la finestra di dialogo di accesso per consentire all'utente finale di continuare il flusso di accesso. Assicurati che il pulsante che fornisci rispetti le linee guida per il branding per l'accesso.
Segui la procedura dettagliata per l'accesso nelle nostre procedure per sviluppatori per implementare un pulsante di accesso con il brand Google su cui è possibile fare clic per attivare la finestra di dialogo di accesso.
Accessi simultanei
Un browser a cui è stato eseguito l'accesso a più account contemporaneamente potrebbe interrompere il flusso dell'utente relativo ai componenti aggiuntivi. Gli utenti finali possono uscire da tutti gli Account Google nel browser corrente oppure aprire Classroom in una finestra di navigazione in incognito in Chrome prima di accedere con l'account corretto e riprovare.
Se un utente errato ha eseguito l'accesso al componente aggiuntivo a causa di un problema di accesso multiplo, le chiamate all'API Classroom add-ons potrebbero non riuscire e generare un errore InvalidAddOnToken. Se visualizzi questo errore, devi chiedere all'utente di uscire da tutti gli altri account nel browser o di aprire Classroom in una finestra di navigazione in incognito di Chrome.