I compiti in Classroom sono chiamati elementi di lavoro del corso e si trovano nella pagina Lavori del corso di qualsiasi corso di Classroom. Sebbene esistano quattro tipi di elementi compiti, questa guida si concentra solo sul tipo "Compito". Se vuoi sapere come gestire gli altri tipi di Lavori del corso, consulta la nostra guida alla gestione di Lavori del corso.
Google Classroom offre due modi per integrarsi con un flusso di lavoro dei compiti: pulsante di condivisione di Classroom e API Classroom. Il pulsante di condivisione consente agli utenti di condividere i contenuti come qualsiasi elemento dello stream tramite una finestra popup di Classroom, mentre l'API Classroom consente un flusso di lavoro dei compiti completo che include la creazione dei 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 gli sviluppatori. Nello specifico, illustreremo le differenze di implementazione e di ogni fase del ciclo di vita dei compiti: creazione dei compiti, invii degli studenti e valutazione/feedback.
Informazioni sul ciclo di vita dei compiti
Prima di passare alle differenze tra il pulsante di condivisione e l'API Coursework, definiamo innanzitutto cosa consideriamo il ciclo di vita di un compito nel contesto di Classroom. In questo modo, potrai capire in che modo insegnanti e studenti interagiscono con i compiti in Classroom.
Esistono cinque passaggi principali da tenere presenti durante l'integrazione con i compiti di Classroom:
- Il compito è stato 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 dei lavori degli studenti, gli utenti possono fare affidamento sulla tua applicazione per gestire questi dettagli per loro.
Implementazione
La prima area di differenza tra il pulsante di condivisione e l'API CourseWork è la implementazione. Dal punto di vista degli sviluppatori, 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ò avere il seguente aspetto:
<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 non è un problema se la tua piattaforma utilizza già altre funzionalità dell'API Classroom, come la formazione dei gruppi.
Creare e condividere i compiti
Sebbene sia il pulsante di condivisione sia l'API CourseWork consentano i primi due passaggi del flusso di lavoro dei compiti, ovvero la creazione e la condivisione del compito con gli studenti, esistono alcune differenze fondamentali da considerare prima di scegliere una soluzione.
Entrambe le soluzioni consentono di pubblicare link o file come compiti in Classroom. Si tratta di un flusso di lavoro efficace per gli insegnanti che altrimenti sarebbero costretti a utilizzare un flusso di lavoro di copia e incolla tra Classroom e l'applicazione di terze parti. Sebbene entrambe le soluzioni supportino la possibilità di pubblicare contenuti come compiti, devi valutare se la tua applicazione ha bisogno della flessibilità di pubblicare questi contenuti come altri tipi di Compiti o anche come avviso.
Entrambe le offerte mostrano tutti i tipi di post di Classroom, ad eccezione dei compiti con quiz. Di seguito è riportato un riepilogo di tutti i tipi di post e se sono esposti.
| Tipo di post | Pulsante Condividi | API CourseWork |
|---|---|---|
| Assignment | X | X |
| Compito con quiz | ||
| Domanda: Risposta breve | X | X |
| Domanda: a scelta multipla | X | X |
| Materiale | X | X |
| Annuncio | X | X |
Funzionalità come la specifica del titolo e della descrizione possono essere anche specificate tramite codice dalla tua applicazione per entrambe le soluzioni. Sebbene l'integrazione del pulsante di condivisione consenta agli utenti di impostare campi come data di consegna, argomento, modalità personalizzata e numero di punti all'interno della finestra di dialogo popup, questi campi non possono essere impostati tramite programmazione da un'app di terze parti. L'API, invece, espone tutti questi campi per l'accesso in lettura e scrittura.
Modificare i compiti
Uno dei vantaggi dell'integrazione con l'API Classroom è che gli utenti non devono più sincronizzare manualmente i dettagli in mutazione dei compiti. Il pulsante di condivisione non ha la funzionalità per aggiornare o eliminare i compiti in modo programmatico, pertanto eventuali modifiche necessarie dovranno essere apportate dall'utente tramite l'interfaccia utente di Classroom.
L'API CourseWork consente sia di modificare ed eliminare i compiti creati dalla tua applicazione sia di recuperare i dettagli di eventuali compiti pubblicati nei corsi dell'utente. È importante notare, tuttavia, che gli elementi di CourseWork non creati dalla stessa Console dello sviluppatore non possono essere modificati dalla stessa Console dello sviluppatore. Questo modello di autorizzazione si estende al resto del ciclo di vita dei compiti, ad esempio la gestione dei compiti inviati dagli studenti e dei voti, a cui non è possibile accedere per questi elementi di Coursework.
Sincronizzare automaticamente i compiti
Con le notifiche push Pub/Sub, la tua applicazione può iscriversi alle notifiche che attivano un evento quando si verificano modifiche agli elementi di Coursework e ai relativi contenuti inviati dagli 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.
Completare e inviare i compiti
A ogni compito sono associati N invii di studenti, dove N è il numero di studenti a cui è stato assegnato il compito. In altre parole, a ogni compito è associato un invio dello studente, a cui è possibile accedere con un ID univoco. Questi compiti inviati dagli studenti vengono creati automaticamente e possono essere recuperati dalla tua applicazione con gli endpoint GET e LIST per i compiti inviati dagli studenti.
Sia il pulsante di condivisione sia l'API CourseWork supportano l'aggiunta di link o file ai contenuti inviati da uno studente per un compito. Il pulsante di condivisione consente di farlo tramite un flusso di lavoro simile a quello della finestra di dialogo per la creazione dei compiti da parte degli insegnanti 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. Questa 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 delle autorizzazioni di Coursework non sia utile per le piattaforme che non supportano la creazione di compiti, un vantaggio è che le piattaforme di terze parti possono impedire agli studenti sia di inviare il compito errato sia di dimenticare di consegnare il proprio lavoro, poiché solo il pulsante di condivisione è limitato per la possibilità degli studenti di consegnare i compiti.
Rivedere e valutare i compiti
L'ultima parte del ciclo di vita del compito torna all'insegnante. Una volta che gli studenti hanno consegnato il compito, l'insegnante può esaminarlo nel modo più opportuno. Nel caso dei file memorizzati su Drive, possono essere esaminati direttamente nello strumento di valutazione di Classroom. Tuttavia, non è possibile accedere alle applicazioni di terze parti nel correttore di Classroom. L'impatto di questa esperienza è che gli insegnanti devono spostarsi tra più schede mentre esaminano e valutano i compiti.
Al momento il pulsante Condividi non offre alcuna soluzione per la valutazione e la restituzione dei compiti. Anche se funzionalità come i commenti sui compiti inviati dagli studenti non sono attualmente esposte tramite l'API, è possibile sia valutare i compiti sia restituire i voti agli studenti tramite gli endpoint studentSubmissions.patch e studentSubmissions.return. I voti possono essere specificati solo per gli elementi dello stream di Coursework (Compiti e Tipi di domande). Sono disponibili solo in formato numerico e possono essere assegnati come bozza o come voto finale.
Riepilogo delle differenze
Per riepilogare 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 sopra: 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 codice JavaScript, che semplificano e velocizzano l'implementazione | Richiede la configurazione delle chiavi API, l'abilitazione delle API nella Console di amministrazione e un monitoraggio più approfondito |
| Creare e condividere compiti |
|
|
| Completare e inviare i compiti |
|
|
| Rivedere e valutare i compiti | Nessun supporto per la specifica o il ritorno dei voti |
|