I compiti in Classroom sono chiamati elementi Lavori del corso e si trovano nella pagina Lavori del corso di qualsiasi corso Classroom. Sebbene esistano quattro tipi di elementi di Lavori di classe, questa guida si concentra solo sul tipo "Compito". Se vuoi scoprire come gestire gli altri tipi di Lavori del corso, leggi la nostra guida Gestire Lavori del corso.
Google Classroom offre due modi per integrarsi con un flusso di lavoro di assegnazione: pulsante di condivisione di Classroom e API Classroom. Il pulsante di condivisione consente agli utenti di condividere contenuti come qualsiasi elemento dello stream tramite una finestra di dialogo popup di Classroom, mentre l'API Classroom consente un flusso di lavoro per i compiti end-to-end che include la creazione di compiti, la creazione e la gestione degli invii degli studenti e il trasferimento dei voti.
Di seguito esamineremo le principali differenze tra queste due offerte per sviluppatori. Più nello specifico, esamineremo le differenze di implementazione e ogni fase del ciclo di vita del compito: creazione del compito, invii degli studenti e valutazione/feedback.
Informazioni sul ciclo di vita di un compito
Prima di passare alle differenze tra il pulsante di condivisione e l'API CourseWork, definiamo innanzitutto il ciclo di vita di un compito nel contesto di Classroom. In questo modo, potrai capire come insegnanti e studenti interagiscono con i compiti in Classroom.
Esistono cinque passaggi principali da tenere a mente durante l'integrazione con gli esercizi di Classroom:
- Il compito viene creato.
- Il compito viene condiviso con gli studenti.
- Lo studente completa il compito.
- Lo studente invia il compito all'insegnante.
- L'insegnante rivede e valuta i compiti.
L'integrazione con i compiti di Classroom consente a insegnanti e studenti di lavorare senza problemi tra Classroom e applicazioni di terze parti. Anziché gestire i dettagli di un compito o gli invii degli studenti, gli utenti possono fare affidamento sulla tua applicazione per gestire questi dettagli.
Implementazione
La prima area di differenza tra il pulsante di condivisione e l'API CourseWork è l'implementazione. Dal punto di vista dello sviluppatore, il pulsante di condivisione è un metodo più semplice per condividere contenuti su Classroom, in quanto richiede solo l'inclusione della risorsa JavaScript necessaria e l'aggiunta di un tag del pulsante di condivisione. Nella sua forma più semplice, l'integrazione del pulsante di condivisione di Classroom può essere simile allo snippet riportato di seguito:
<script src="https://apis.google.com/js/platform.js" async defer></script>
<g:sharetoclassroom url="http://url-to-share" size="32"></g:sharetoclassroom>
L'API CourseWork, invece, fa parte dell'API REST di Google Classroom, che richiede la configurazione e l'attivazione delle chiavi API con la console Google Cloud e il rispetto delle best practice per l'integrazione con un'API. Questo problema è meno preoccupante se la tua piattaforma sfrutta già altre funzionalità dell'API Classroom, come l'elenco.
Creare e condividere compiti
Sebbene sia il pulsante di condivisione sia l'API CourseWork consentano i primi due passaggi del flusso di lavoro degli incarichi, ovvero la creazione e la condivisione dell'incarico con gli studenti, esistono alcune differenze cruciali da considerare prima di scegliere una soluzione.
Entrambe le soluzioni consentono di pubblicare link o file come compiti in Classroom. Questo rappresenta un flusso di lavoro efficace per gli insegnanti che altrimenti sarebbero costretti a copiare e incollare tra Classroom e l'applicazione di terze parti. Sebbene entrambe le soluzioni supportino la possibilità di pubblicare contenuti come compito, devi valutare se la tua applicazione ha bisogno della flessibilità di pubblicare questi contenuti come altri tipi di Lavori di classe o anche come annuncio.
Entrambe le offerte espongono tutti i tipi di post di Classroom, ad eccezione dei compiti a quiz. Di seguito è riportato un riepilogo di tutti i tipi di post e della loro visibilità.
| Tipo di post | Pulsante Condividi | API CourseWork |
|---|---|---|
| Assignment | X | X |
| Quiz | ||
| Domanda: risposta breve | X | X |
| Domanda: scelta multipla | X | X |
| Materiale | X | X |
| Annuncio | X | X |
Funzionalità come la specifica del titolo e della descrizione possono anche essere specificati a livello di programmazione dalla tua applicazione per entrambe le soluzioni. L'integrazione del pulsante di condivisione consente agli utenti di impostare campi come data di scadenza, argomento, modalità personalizzata e numero di punti all'interno della finestra di dialogo popup, ma non possono essere impostati a livello di programmazione da un'app di terze parti. L'API, invece, espone tutti questi campi per l'accesso in lettura e scrittura.
Modifica delle assegnazioni
L'integrazione con l'API Classroom elimina la necessità di sincronizzare manualmente i dettagli modificati dei compiti. Il pulsante di condivisione non dispone della funzionalità per aggiornare o eliminare i compiti in modo programmatico, quindi qualsiasi modifica necessaria deve essere apportata dall'utente tramite l'interfaccia utente di Classroom.
L'API CourseWork consente sia di modificare ed eliminare i compiti creati dall'applicazione, sia di recuperare i dettagli di tutti i compiti pubblicati nei corsi dell'utente. Tuttavia, è importante notare che gli elementi di CourseWork non creati dalla stessa console per gli sviluppatori non possono essere modificati da quest'ultima. Questo modello di autorizzazioni si estende al resto del ciclo di vita del compito, ad esempio la gestione degli invii e dei voti degli studenti, non è possibile accedere a questi elementi di CourseWork.
Sincronizzare automaticamente i compiti
Con le notifiche push di Pub/Sub, la tua applicazione può abbonarsi alle notifiche che attivano un evento quando si verificano modifiche agli elementi di CourseWork e ai relativi invii degli studenti. In questo modo, la tua applicazione può sincronizzare facilmente i compiti eliminando la necessità di controlli continui per verificare se i contenuti sono stati aggiornati su Classroom.
Completamento e invio dei compiti
Ogni compito è associato a N invii degli studenti, dove N è il
numero di studenti a cui è stato assegnato il compito. In altre parole, per ogni
compito, esiste un invio dello studente associato a ogni studente, a cui
è possibile accedere con un ID univoco. Questi compiti consegnati dagli studenti vengono creati automaticamente e possono essere recuperati dalla tua applicazione con gli endpoint GET e LIST dei compiti consegnati dagli studenti.
Sia il pulsante di condivisione sia l'API CourseWork supportano l'aggiunta di link o file all'invio di uno studente per un compito. Il pulsante di condivisione lo consente tramite un flusso di lavoro simile alla finestra di dialogo di creazione dei compiti per l'insegnante e l'API CourseWork tramite l'endpoint studentSubmissions.modifyAttachments. Tuttavia, a causa delle limitazioni delle autorizzazioni API descritte in precedenza, questa funzionalità è limitata agli elementi di CourseWork creati dalla tua applicazione. La stessa limitazione non vale per il pulsante di condivisione: gli studenti possono aggiungere il proprio lavoro a qualsiasi compito selezionato da Classroom.
Terminare il flusso di lavoro dello studente
Sebbene la limitazione dell'autorizzazione CourseWork non serva a uno scopo per le piattaforme che non supportano la creazione di compiti, un vantaggio è che le piattaforme di terze parti possono impedire agli studenti di inviare il compito errato e di dimenticare di consegnare il proprio lavoro, poiché solo il pulsante di condivisione è limitato alla possibilità per gli studenti di consegnare i propri compiti.
Revisione e valutazione dei compiti
L'ultima parte del ciclo di vita del compito riguarda l'insegnante. Una volta che gli studenti hanno consegnato correttamente il compito, l'insegnante può esaminarlo nel modo più opportuno. Nel caso di file memorizzati in Drive, possono essere rivisti direttamente nel valutatore di Classroom. Le applicazioni di terze parti, tuttavia, non sono accessibili nel programma di valutazione di Classroom. L'implicazione di questa esperienza è che gli insegnanti devono navigare tra più schede durante la revisione e la valutazione dei compiti.
Al momento, il pulsante di condivisione non offre alcuna soluzione per la valutazione e la restituzione dei compiti. Sebbene funzionalità come i commenti ai compiti inviati dagli studenti non siano attualmente esposte tramite l'API, sia l'assegnazione dei voti sia la restituzione di questi voti agli studenti sono possibili tramite gli endpoint studentSubmissions.patch e studentSubmissions.return. I voti possono essere specificati solo per gli elementi del flusso di CourseWork (tipi Compito e Domanda). Sono disponibili solo in formato numerico e possono essere assegnati come bozza o voto finale.
Riepilogo delle differenze
Per riassumere tutto ciò che è stato esaminato nelle sezioni precedenti, la tabella seguente mostra un confronto affiancato del pulsante di condivisione e dell'API CourseWork per le quattro categorie discusse in precedenza: implementazione, creazione e condivisione dei compiti, completamento e invio dei compiti, nonché revisione e valutazione dei compiti.
| Pulsante Condividi | API CourseWork | |
|---|---|---|
| Implementazione | Solo poche righe di JavaScript, il che rende l'implementazione semplice e rapida | Richiede la configurazione delle chiavi API, l'abilitazione delle API nella Console di amministrazione e un monitoraggio più attento. |
| Creare e condividere compiti |
|
|
| Completare e inviare i compiti |
|
|
| Revisione e valutazione dei compiti | Nessun supporto per la specifica o la restituzione dei voti |
|