Poiché l'esperienza di accesso è la prima interazione che un utente può avere con il tuo componente aggiuntivo, è importante che siano in grado di completare il flusso con la stessa possibile. Leggi le sezioni riportate di seguito per acquisire familiarità con i vari API di accesso, parametro di query relativo all'accesso, come gestire i blocchi popup e un piano di test che puoi usare durante lo sviluppo per assicurarti di seguire best practice.
Dettagli implementazione SSO
OAuth 2.0 di Google è compatibile con molte 2.0 stack. Consigliamo vivamente di implementare l'autorizzazione lato server è l'opzione di sicurezza più elevata e supporta l'uso della query iframe parametri.
Consulta le indicazioni tecniche fornite nel sito web di Google Identity quando implementando Accedi con Google. Assicurati di seguire il branding di Accedi con Google linee guida. Puoi scaricare file di schizzo, SVG ed EPS.
Test di accesso
Utilizza il piano di test dei componenti aggiuntivi per verificare che soddisfi le standard richiesti e in grado di gestire casi limite noti prima di inviare per la revisione. Questi test rispecchiano fedelmente il componente aggiuntivo di Classroom. elenco di controllo dei requisiti, con istruzioni passo passo su come controllarli se il tuo componente aggiuntivo soddisfa questi requisiti. Si tratta degli stessi test rispetto ai quali la tua applicazione viene testata durante la pubblicazione.
Parametri di query di accesso
Google Classroom fornisce il parametro di query login_hint
per facilitare
ripetuti accessi. Consulta la sezione relativa ai parametri relativi all'accesso dell'iframe
parametri di ricerca per ulteriori informazioni. Il codice campione è disponibile in
la procedura dettagliata per le visite ripetute sugli handle, delle nostre procedure dettagliate per gli sviluppatori.
Gestisci i blocchi popup
L'accesso al componente aggiuntivo è consentito dalla finestra di dialogo di accesso. Questo mostra la schermata del selettore degli account e consente all'utente di concedere OAuth autorizzazioni aggiuntive. Il blocco popup di un utente finale potrebbe impedirgli di completare flusso di accesso.
Figura 1. Un esempio di schermata di selezione degli account.
Per risolvere il problema, fornisci all'utente finale un pulsante da fare clic per ignorare il blocco popup. Questa interazione consente di visualizzare la finestra di dialogo di accesso per consentire all'utente finale di continuare la procedura di accesso. Assicurati che il pulsante rispettino le linee guida per il branding per l'accesso.
Segui la procedura dettagliata di accesso nelle nostre procedure dettagliate per gli sviluppatori per implementare una Pulsante di accesso con brand Google su cui è possibile fare clic per attivare la finestra di dialogo di accesso.
Accessi simultanei
Un browser su cui hai eseguito l'accesso a più account contemporaneamente potrebbe interrompere la la procedura dei componenti aggiuntivi. Gli utenti finali possono uscire da tutti gli Account Google nei propri browser corrente o aprire Classroom in una finestra di navigazione in incognito di Chrome prima di accedere con l'account corretto e di riprovare l'operazione.
Se un utente errato ha eseguito l'accesso al componente aggiuntivo a causa del problema di accesso multiplo,
le chiamate all'API per i componenti aggiuntivi di Classroom potrebbero non riuscire a causa di
InvalidAddOnToken
. Se ricevi un errore di questo tipo, devi indicare
all'utente di uscire da tutti gli altri account nel browser o di aprire
Classroom in una finestra di navigazione in incognito di Chrome.