Introduzione

I compiti di Classroom sono chiamati elementi CourseWork e puoi trovarli nella pagina Lavori del corso di un determinato corso di Classroom. Anche se ci sono quattro tipi di elementi della pagina Lavori del corso, 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 i lavori del corso.

Google Classroom offre due modalità di integrazione con un flusso di lavoro dei compiti: il pulsante di condivisione Classroom e l'API Classroom. Il pulsante di condivisione consente agli utenti di condividere i contenuti come qualsiasi elemento dello stream attraverso una finestra di dialogo popup di Classroom, mentre l'API Classroom consente un flusso di lavoro per l'assegnazione dall'inizio alla fine che include la creazione dei compiti, la creazione e la gestione dei contenuti inviati dagli studenti e l'invio dei voti.

Qui esamineremo le principali differenze tra queste due offerte per sviluppatori. In particolare, analizzeremo le differenze nell'implementazione e in ogni fase del ciclo di vita del compito: creazione dei compiti, invio degli studenti e valutazione/feedback.

Informazioni sul ciclo di vita dei compiti

Prima di passare alle differenze tra il pulsante Condividi e l'API CourseWork, definiamo il ciclo di vita di un compito nel contesto di Classroom. per capire come insegnanti e studenti interagiscono con i compiti in Classroom.

Ci sono cinque passaggi principali da tenere a mente durante l'integrazione con i compiti di Classroom:

1. Compito creato.
2. Il compito viene condiviso con gli studenti.
3. Lo studente completa il compito.
4. Lo studente invia il compito all'insegnante.
5. Le recensioni degli insegnanti e i voti dei 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 contenuti inviati dagli studenti, gli utenti possono affidarsi alla tua applicazione per gestire questi dettagli.

Implementazione

La prima area della 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 in Classroom, in quanto richiede solo l'inclusione della risorsa JavaScript necessaria e l'aggiunta di un tag del pulsante di condivisione. Nel formato più semplice, l'integrazione del pulsante di condivisione di Classroom può essere simile al seguente snippet:

<script src="https://apis.google.com/js/platform.js" async defer></script>
<g:sharetoclassroom url="http://url-to-share" size="32"></g:sharetoclassroom>

Puoi scoprire di più sull'integrazione con il pulsante di condivisione qui.

L'API CourseWork, invece, fa parte dell'API REST dell'API Google Classroom, che richiede la configurazione e l'attivazione delle chiavi API con la console Google Cloud e le seguenti best practice per l'integrazione con un'API. Questo non è un problema se la tua piattaforma utilizza già altre funzionalità dell'API Classroom, ad esempio l'rostering.

Creare e condividere compiti

Sebbene sia il pulsante Condividi sia l'API CourseWork consentono i primi due passaggi del flusso di lavoro dei compiti, ovvero la creazione e la condivisione del compito con gli studenti, ci sono alcune differenze fondamentali che dovresti considerare prima di scegliere una soluzione.

Essenzialmente, entrambe le soluzioni consentono di pubblicare link o file come compiti in Classroom. Questo è un flusso di lavoro efficace per gli insegnanti che altrimenti sarebbero costretti a eseguire 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 un compito, devi valutare se la tua applicazione ha bisogno della flessibilità per pubblicare questi contenuti come altri tipi di lavori del corso o persino come annuncio.

Entrambe le offerte espongono tutti i tipi di post di Classroom, ad eccezione di Compiti quiz. Di seguito è riportato un riepilogo di tutti i tipi di post e della relativa visibilità.

Tipo di post	Pulsante Condividi	API CourseWork
Assignment	X	X
Compito con quiz
Question: Risposta breve	X	X
Question: Scelta multipla	X	X
Materiale	X	X
Annuncio	X	X

Funzionalità come la specifica di titolo e descrizione possono anche essere specificate in modo programmatico dall'applicazione per entrambe le soluzioni. Sebbene l'integrazione del pulsante Condividi consenta agli utenti di impostare campi come data di scadenza, argomento, modalità personalizzata e numero di punti all'interno della finestra di dialogo popup, non possono essere impostati in modo programmatico da un'app di terze parti. L'API, invece, espone tutti questi campi per l'accesso in lettura e scrittura.

Inoltre, il pulsante Condividi non consente all'applicazione di specificare campi specifici per i tipi di domanda, ad esempio Opzioni a scelta multipla.

Modificare i compiti

Eliminare la necessità di sincronizzare manualmente gli utenti cambiando i dettagli dei loro compiti è uno dei vantaggi dell'integrazione con l'API Classroom. Il pulsante Condividi non dispone di funzionalità che consentono di aggiornare o eliminare i compiti in modo programmatico, pertanto tutte le modifiche necessarie devono essere apportate 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 eventuali compiti pubblicati nei corsi dell'utente. Tuttavia, è importante notare che gli elementi CourseWork non creati dalla stessa console per gli sviluppatori non possono essere modificati da questa console. Questo modello di autorizzazione si estende al resto del ciclo di vita dei compiti, ad esempio per la gestione dei contenuti inviati e dei voti degli studenti, per questi elementi di CourseWork non è possibile accedere.

Sincronizza automaticamente i compiti

Con le notifiche push di Pub/Sub, la tua applicazione può iscriversi alle notifiche che attivano un evento quando vengono apportate modifiche agli elementi di CourseWork e ai contenuti inviati dagli studenti associati. Ciò consente all'applicazione di sincronizzare facilmente i compiti eliminando la necessità di controlli continui per verificare se i contenuti sono stati aggiornati in Classroom.

Completamento e invio dei compiti

Ogni compito è associato a N compiti consegnati dagli studenti, dove N è il numero di studenti a cui è stato assegnato il compito. In altre parole, a ogni compito è associato un invio per studente e a cui è possibile accedere con un ID univoco. I compiti degli studenti vengono creati automaticamente e possono essere recuperati dalla tua applicazione mediante gli endpoint GET ed LIST.

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 Condividi consente di eseguire questa operazione tramite un flusso di lavoro simile a quello della finestra di dialogo per la creazione dei compiti dell'insegnante e dell'API CourseWork tramite l'endpoint studentSubmissions.modifyAttachments. Tuttavia, a causa delle limitazioni delle autorizzazioni API descritte in precedenza, questa funzionalità è limitata agli elementi CourseWork creati dall'applicazione. Questa stessa limitazione non è valida 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 un caso d'uso per le piattaforme che non supportano la creazione di compiti, un vantaggio è che le piattaforme di terze parti possono impedire agli studenti di inviare un compito errato e dimenticarsi di consegnare il lavoro poiché solo il pulsante Condividi è limitato dalla possibilità per gli studenti di consegnare i compiti.

A partire da novembre 2019, il pulsante di condivisione consente di specificare il corso a cui lo studente aggiunge un allegato, ma non supporta la selezione automatica dei compiti. Considera il rischio che gli studenti si inviino al compito sbagliato.

Esaminare 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ò ora esaminarlo nel modo più appropriato. Nel caso di file archiviati in Drive, possono esaminarli direttamente nello strumento di valutazione di Classroom. Le applicazioni di terze parti, tuttavia, non sono accessibili nello strumento di valutazione di Classroom. L'impatto di questa esperienza è che gli insegnanti devono navigare tra più schede durante la revisione e la valutazione dei compiti.

Il pulsante di condivisione al momento non offre alcuna soluzione per la valutazione e la restituzione dei compiti. Sebbene al momento funzionalità come i commenti inviati dagli studenti non siano disponibili tramite l'API, sia la valutazione sia l'invio dei voti agli studenti sono possibili attraverso gli endpoint studentSubmissions.patch e studentSubmissions.return. I voti possono essere specificati solo per gli elementi dello stream CourseWork (tipi di compiti e domande). Sono disponibili solo in forma numerica e possono essere assegnati come voto provvisorio o finale.

Per restituire o valutare i compiti, è necessario prima consegnare i contenuti inviati dallo studente. Al momento si tratta di una mancata corrispondenza tra il funzionamento dell'interfaccia utente e dell'API di Classroom.

Riepilogo delle differenze

Per riassumere tutto ciò che è stato esaminato nelle sezioni precedenti, la tabella seguente mostra un confronto affiancato tra il pulsante Condividi e l'API CourseWork per le quattro categorie discusse sopra: implementazione, creazione e condivisione dei compiti, completamento e invio dei compiti, 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 di chiavi API, l'abilitazione delle API nella Console di amministrazione e un monitoraggio più approfondito
Creazione e condivisione di compiti	Reindirizza gli insegnanti alla finestra di dialogo per la condivisione del pulsante di condivisione di Classroom Gli utenti possono pubblicare tutti i tipi di elementi dello stream tranne un È possibile specificare meno campi Uno consente la creazione di compiti, nessuna possibilità di estrarre o modificare i dati dei compiti	Finestra di dialogo con il pulsante Condividi non necessaria È possibile specificare la maggior parte dei campi dei compiti di Classroom Può modificare le attività del corso create dalla tua applicazione Consente all'app di estrarre tutti i dati dei compiti da Classroom
Completamento e invio di compiti	Reindirizza gli studenti alla finestra di dialogo per la condivisione del pulsante di condivisione di Classroom Consente agli studenti di allegare i contenuti inviati a qualsiasi compito di Classroom One abilita gli allegati dell'invio, nessuna possibilità di estrarre o modificare i dati di invio Non consente agli studenti di consegnare il compito	Finestra di dialogo con il pulsante Condividi non necessaria Consente agli studenti di allegare i contenuti inviati solo ai compiti creati dalla tua app Consente alla tua app di modificare i compiti degli studenti creati dalla tua applicazione Consente agli studenti di consegnare i compiti
Revisione e valutazione dei compiti	Nessun supporto per specificare o inviare i voti	Consente alla tua app di estrarre tutti i dati relativi ai contenuti inviati dagli studenti da Classroom per conto di un insegnante Espone la possibilità di assegnare i voti agli studenti, come provvisori o finali Espone la possibilità di modificare i voti degli studenti Espone la possibilità di restituire i voti agli studenti