Integrazione di CourseWork

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

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

Come funziona

La funzionalità di base di un'integrazione di CourseWork è la creazione e la gestione di compiti, annunci e materiali dei corsi utilizzando l'API Classroom.

Un esempio di percorso dell'utente comune consentito da un'integrazione CourseWork è consentire agli insegnanti di scoprire, assegnare e valutare 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 da condividere con il suo corso. L'insegnante fa clic su un pulsante sul 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 del compito.
   • La descrizione del testo del compito.
   • Un elemento link Material con l'URL dei contenuti selezionati dall'insegnante.
   • Facoltativamente, il punteggio massimo ottenibile per i contenuti selezionati.
4. In Classroom viene visualizzato un nuovo compito con un allegato link. Il link fa riferimento all'URL specificato nella richiesta create. Vedi la Figura 1 per un esempio.
5. Nel registro compiti 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. Se vuoi, invia una richiesta a courses.courseWork.studentSubmissions.modifyAttachments per aggiungere allegati a un compito inviato dallo studente, ad esempio un file di Google Drive o un link Material che rimandi al lavoro dello studente sul tuo sito web.
8. Se vuoi, invia una richiesta a courses.courseWork.studentSubmissions.patch per impostare il voto dello studente per il compito.

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

In alternativa, puoi chiamare courses.announcements.create o courses.courseWorkMaterials.create per creare un annuncio o materiale didattico instead of an assignment. Consulta le pagine Creare e gestire le attività del corso e Impostare e aggiornare i voti per descrizioni dettagliate delle azioni pertinenti dell'API Classroom.

Considerazioni

Tieni presente quanto segue prima di decidere se un'integrazione di CourseWork è la scelta giusta per le tue esigenze di 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, ma solo nei corsi insegnati dall'utente autorizzato.
• Devi trovare un modo per consentire all'utente di selezionare un corso per ricevere i contenuti. Valuta la possibilità di utilizzare 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à alcuna informazione da Classroom quando si apre l'URL.
• Un insegnante può modificare o eliminare i contenuti del corso indipendentemente dall'autore. Ciò significa che le conoscenze di uno sviluppatore sui corsi potrebbero diventare obsolete. Se devi essere a conoscenza delle modifiche ai corsi, valuta la possibilità di configurare le notifiche push per le modifiche ai corsi.
• Un insegnante può creare i compiti nell'interfaccia utente di Classroom incollando i link agli URL sul tuo sito web. I lavori creati in questo modo sono di proprietà esclusiva dell'insegnante, pertanto non potrai visualizzare, modificare o impostare i voti dei compiti utilizzando l'API Classroom.