Learning Tools Interoperability (LTI) è un framework aperto per la creazione di integrazioni di terze parti nei sistemi di gestione dell'apprendimento. Sebbene i componenti aggiuntivi di Classroom e gli strumenti LTI supportino percorsi utente simili, i due framework non sono direttamente compatibili. Questa guida confronta i due tipi di integrazione ed evidenzia le principali differenze. Suggerisce inoltre modi per ottenere percorsi utente simili quando si adatta uno strumento LTI per funzionare come componente aggiuntivo di Classroom.
Interazioni tra la piattaforma e gli strumenti
Una distinzione fondamentale tra gli strumenti LTI e i componenti aggiuntivi di Classroom è la
modalità di scambio delle informazioni. In genere, gli strumenti LTI utilizzano HTTP POST per
trasmettere payload a una piattaforma LTI, mentre i componenti aggiuntivi di Classroom
creano e recuperano risorse utilizzando l'API REST di Google Classroom.
La seguente tabella riassume come ottenere i comportamenti chiave degli strumenti LTI con Google Classroom.
| Funzionalità | LTI | Classroom |
|---|---|---|
| Creare compiti | Servizi di assegnazione e valutazione | Creare risorse CourseWork e AddOnAttachment |
| Pubblicare i voti | Servizi di assegnazione e valutazione | Patch CourseWork e AddOnAttachment invii degli studenti |
| Avviare le route | Deep linking | Specifica gli URI nelle risorse AddOnAttachment |
| Leggere gli elenchi del corso | Servizi di provisioning di nomi e ruoli | Recuperare i profili Student e Teacher in un corso |
Adattare uno strumento LTI a un componente aggiuntivo di Classroom
Molte interazioni LTI hanno analoghi nel framework dei componenti aggiuntivi di Classroom. Le sezioni seguenti illustrano alcuni concetti chiave e le azioni consigliate.
Configura la tua applicazione
Tutte le interazioni programmatiche con Google Classroom richiedono un progetto Google Cloud. Configurerai la scheda dell'applicazione nello stesso progetto Cloud, che definisce l'aspetto del componente aggiuntivo Classroom per gli utenti finali. Fornirai le icone, imposterai il nome e la descrizione dell'app e configurerai le autorizzazioni di ambito OAuth richieste dal tuo prodotto.
L'installazione dell'applicazione componente aggiuntivo dall'elenco è spesso l'unico passaggio di configurazione che gli utenti finali devono eseguire. È analogo all'attivazione e all'implementazione di uno strumento LTI. Gli utenti finali non dovranno completare alcuna azione di registrazione o gestire alcun dettaglio di configurazione, anche se un amministratore potrebbe dover consentire l'app in Marketplace e configurare le autorizzazioni di accesso ai dati di terze parti.
Consiglio: segui la nostra guida per creare e configurare un progetto Google Cloud per un componente aggiuntivo di Classroom. Ancora più importante, specifica un URL per l'avvio del componente aggiuntivo come URI di rilevamento allegati nell'SDK di Marketplace. Questo URL può essere uguale a una route di avvio di uno strumento LTI esistente, purché indirizzi l'utente al flusso di autenticazione appropriato.
Flusso di autenticazione
LTI utilizza un flusso a due gambe in cui un'applicazione client e un server di autenticazione scambiano un JWT firmato. Gli utenti non devono concedere a uno strumento l'accesso ai propri dati, poiché il consenso è implicito quando un amministratore configura lo strumento.
Al contrario, il flusso OAuth di Google è un flusso a 3 vie che coinvolge l'utente finale, l'applicazione client esterna e il server di autenticazione. Il client riceve token con il consenso esplicito dell'utente che concedono l'accesso alle risorse di Google Classroom dell'utente.
È possibile che un'applicazione componente aggiuntivo ottenga un comportamento JWT firmato a due passaggi simile utilizzando service account. Si tratta di account che appartengono a un'applicazione anziché a un singolo utente e possono intraprendere azioni senza il consenso dell'utente. L'utilizzo dei service account richiede la configurazione e la gestione da parte dell'amministratore. L'utilizzo di service account con delega a livello di dominio è fortemente sconsigliato, in quanto sono potenziali vettori di abuso. Per ulteriori dettagli, consulta la nostra guida alla delega a livello di dominio con le integrazioni di Google Classroom.
Consiglio: quando un URL associato al tuo strumento o componente aggiuntivo riceve una richiesta in entrata, esamina la richiesta per verificare la presenza di parametri di ricerca del componente aggiuntivo Classroom. Se presente, utilizza l'SDK Google Identity per ottenere le credenziali di accesso per l'utente. Memorizza le credenziali nella sessione dell'utente e utilizzale per effettuare richieste successive all'API Classroom. Se i parametri di query non sono presenti, utilizza le richieste HTTP per interagire con gli endpoint LTI della piattaforma.
Creare contenuti dei componenti aggiuntivi in Google Classroom
I componenti aggiuntivi di Classroom supportano un solo tipo di contenuti: link URL a pagine
ospitate esternamente. Questi link sono contenuti nelle risorse AddOnAttachment, che definiscono i percorsi web da aprire quando un utente interagisce con il tuo componente aggiuntivo. Ogni URL si apre in scenari specifici. Per tutti i dettagli, consulta le nostre
guide agli iframe. Questi URL sono analoghi ai link alle risorse LTI.
I componenti aggiuntivi di Classroom non supportano altri tipi di contenuti come file, immagini o frammenti HTML.
Consiglio: quando un utente seleziona contenuti nel tuo prodotto, ottieni le sue
credenziali OAuth ed effettua una richiesta AddOnAttachments.create. La richiesta
deve contenere un oggetto AddOnAttachment contenente gli URL per una visualizzazione dello studente, una visualizzazione dell'insegnante e (facoltativamente) una visualizzazione della valutazione. Tieni presente che esistono
endpoint API separati per la creazione di allegati per annunci,
compiti o materiali del corso. Solo gli allegati
creati nei compiti possono avere la visualizzazione della valutazione, in quanto si tratta dell'unico tipo di
elemento dello stream di Classroom che accetta un compito consegnato da uno studente.
Confronto delle funzionalità del framework
Posizionamenti dell'integrazione
I componenti aggiuntivi di Classroom creano allegati su annunci, compiti e materiali del corso. Questi sono gli elementi che vengono visualizzati nella scheda Stream di un corso nella UI di Classroom.
Gli insegnanti iniziano il percorso di creazione degli allegati dei componenti aggiuntivi selezionando un componente aggiuntivo in un selettore nel flusso di creazione dei compiti. Consulta le guide agli iframe per una discussione dettagliata di ogni visualizzazione presentata agli utenti.
In alternativa, gli sviluppatori possono creare programmaticamente compiti con allegati di componenti aggiuntivi. Per maggiori dettagli, consulta la nostra guida alla creazione di allegati al di fuori di Google Classroom.
Informazioni sul contesto del lancio
Classroom aggiunge diversi parametri di ricerca a ogni URL quando apre un percorso del componente aggiuntivo. Questi includono sempre il tipo di articolo del flusso e gli identificatori del corso e dell'elemento del flusso. A seconda della visualizzazione iframe, potrebbero essere presenti altre informazioni, come gli identificatori di allegati o invii, un token per autorizzare la creazione di allegati o l'URL per eseguire l'upgrade da un link a un allegato del componente aggiuntivo.
Per impostazione predefinita, Classroom non trasmette alcuna informazione sull'utente o sull'istituto. Puoi ottenere informazioni sull'utente dalla risorsa UserProfile dell'API Classroom, incluso un ID utente. Se l'utente è un amministratore di dominio, puoi ottenere informazioni sull'istituto dall'SDK Admin di Workspace.
Autenticazione e autorizzazione
I componenti aggiuntivi di Classroom devono utilizzare Accedi con Google per l'autenticazione dell'utente. Una volta eseguito l'accesso, gli utenti concedono l'autorizzazione alla tua applicazione tramite gli ambiti OAuth 2.0. La tua applicazione può utilizzare qualsiasi combinazione di ambiti OAuth disponibili.
Individuazione e configurazione delle app
Gli utenti trovano e "installano" i componenti aggiuntivi di Classroom tramite Google Workspace Marketplace. L'installazione con un clic rende un'applicazione componente aggiuntivo disponibile per un singolo insegnante. Facoltativamente, un amministratore può installare l'applicazione componente aggiuntivo per tutti gli insegnanti di un'unità organizzativa o di un dominio. Gli allegati creati con l'applicazione sono quindi accessibili a tutti gli studenti di un corso. Gli utenti finali non devono gestire token, chiavi o identificatori per i singoli componenti aggiuntivi di Classroom.
UX e flusso del prodotto
In molti casi, il flusso di prodotto esistente di uno strumento LTI funziona bene come componente aggiuntivo di Classroom. Analogamente a uno strumento LTI, un componente aggiuntivo di Classroom ti consente essenzialmente di creare e gestire link ai tuoi contenuti sulla nostra piattaforma. Gli allegati dei componenti aggiuntivi di Classroom sono simili ai link diretti LTI. Se il tuo strumento LTI crea URL che rimandano ai tuoi contenuti ospitati, dovrebbe funzionare bene come componente aggiuntivo di Classroom.
Valutare i lavori degli studenti
I componenti aggiuntivi di Classroom da allegare possono essere visualizzati e valutati nella
visualizzazione del valutatore di Classroom. Quando alleghi contenuti che richiedono l'invio di un lavoro da parte dello studente, fornisci un student_work_review_uri in cui un insegnante può visualizzare e valutare il lavoro di un determinato studente. Questo è diverso da
LTI, in cui uno strumento definisce solo un target_link_uri comune sia
a insegnanti che a studenti. L'implementazione dei componenti aggiuntivi di Classroom è
molto simile al futuro servizio di revisione degli invii LTI.