Integrazione di CourseWork

Gli sviluppatori possono utilizzare l'API Google Classroom per interagire con i compiti in Google Classroom. Un'applicazione che utilizza l'API in questo modo viene definita integrazione CourseWork.

Questo percorso di integrazione viene comunemente utilizzato per creare e valutare i compiti con link a risorse esterne a Classroom. Offre agli sviluppatori un maggiore accesso alla gestione dei lavori del corso rispetto ai pulsanti di condivisione di Classroom.

Come funziona

La funzionalità principale di un'integrazione CourseWork è la creazione e la gestione di compiti, annunci e materiali del corso utilizzando l'API Classroom.

Un esempio di percorso dell'utente comune reso possibile da un'integrazione CourseWork è quello di consentire agli insegnanti di scoprire, assegnare e valutare i contenuti dal tuo sito web o dalla tua applicazione:

1. Un utente insegnante accede al tuo sito web.
2. L'insegnante trova o crea contenuti che vuole condividere con la sua classe. L'insegnante fa clic su un pulsante del tuo sito web per inviare questi contenuti a Google Classroom.
3. La tua applicazione invia una richiesta a courses.courseWork.create. La richiesta contiene un oggetto CourseWork nel corpo che contiene:
   • L'ID del corso di destinazione.
   • Il titolo dell'assegnazione.
   • Il testo descrittivo del compito.
   • Un link Material con l'URL dei contenuti selezionati dall'insegnante.
   • (Facoltativo) Il punteggio massimo ottenibile per i contenuti selezionati.
4. In Classroom viene visualizzato un nuovo compito con un allegato di link. Il link fa riferimento all'URL specificato nella richiesta create. Per un esempio, vedi la Figura 1.
5. Nel registro di Classroom viene visualizzata anche una nuova colonna per il compito, incluso il punteggio massimo, se fornito.
6. Gli studenti ricevono il compito e fanno clic su link Material per aprire l'URL fornito in una nuova scheda e visualizzare o completare i contenuti sul tuo sito web. (Facoltativo) Fornisci i controlli per consentire allo studente di consegnare il compito.
7. (Facoltativo) Invia una richiesta a courses.courseWork.studentSubmissions.modifyAttachments per aggiungere allegati a un invio dello studente, ad esempio un file di Google Drive o link Material che rimanda al lavoro dello studente sul tuo sito web.
8. (Facoltativo) Invia una richiesta a courses.courseWork.studentSubmissions.patch per impostare il voto dello studente per il compito.

Figura 1. Visualizzazione dell'insegnante durante la modifica di un compito con link Material creato da un'integrazione CourseWork.

In alternativa, puoi chiamare il numero courses.announcements.create o courses.courseWorkMaterials.create per creare un annuncio o materiale del corso anziché un compito. Consulta le pagine Creare e gestire i compiti e Impostare e aggiornare i voti per descrizioni dettagliate delle azioni dell'API Classroom pertinenti.

Considerazioni

Tieni presente quanto segue prima di decidere se l'integrazione di CourseWork è la scelta giusta per le esigenze del tuo prodotto.

• Devi autorizzare l'utente e richiedere il suo consenso. Stai effettuando richieste API per conto dell'utente. Ciò significa, ad esempio, che non puoi creare compiti in nessun corso Google Classroom; puoi creare compiti solo nei corsi in cui l'utente autorizzato insegna.
• Devi fornire all'utente un modo per selezionare un corso per ricevere i contenuti. Prendi in considerazione l'utilizzo di courses.list per ottenere un elenco dei corsi insegnati dall'utente, quindi consenti all'utente di selezionare uno o più corsi dall'elenco.
• Quando un utente fa clic su un link Material in Classroom, il link si apre in una nuova scheda. Il server non riceverà informazioni da Classroom quando si apre l'URL.
• Un insegnante può modificare o eliminare il materiale del corso indipendentemente dallo sviluppatore. Ciò significa che le conoscenze di uno sviluppatore sui corsi potrebbero diventare obsolete. Se devi essere a conoscenza delle modifiche apportate ai compiti, valuta la possibilità di configurare le notifiche push per le modifiche ai compiti.
• Un insegnante può creare compiti nella UI di Classroom con link incollati agli URL del tuo sito web. I compiti creati in questo modo sono di proprietà esclusiva dell'insegnante, quindi non potrai visualizzare, modificare o impostare i voti per la consegna utilizzando l'API Classroom.