Integrazione di CourseWork

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

Questo percorso di integrazione è di uso comune per creare e valutare i compiti con link a risorse esterne a Classroom. Fornisce 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 utente comune abilitato da un'integrazione CourseWork è consentire agli insegnanti di scoprire, assegnare e valutare i contenuti dal tuo sito web o dalla tua applicazione:

  1. Un insegnante accede al tuo sito web.
  2. L'insegnante trova o crea contenuti che vuole condividere con il suo corso. 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. Il corpo della richiesta contiene un oggetto CourseWork che include:
    • L'ID del corso di destinazione.
    • Il titolo del compito.
    • 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 dei voti 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.

Modificare un compito di CourseWork con un allegato di materiale con link

Figura 1. Visualizzazione dell'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 un materiale del corso anziché un compito. Per descrizioni dettagliate delle azioni dell'API Classroom pertinenti, consulta le pagine Creare e gestire i lavori del corso e Impostare e aggiornare i voti.

Considerazioni

Tieni presente quanto segue prima di decidere se un'integrazione 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 lavori del corso in qualsiasi corso di Google Classroom, ma solo nei corsi in cui l'utente autorizzato è insegnante.
  • Devi fornire all'utente un modo per selezionare un corso in cui ricevere i contenuti. Valuta la possibilità di utilizzare courses.list per ottenere un elenco dei corsi tenuti 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. Quando l'URL si apre, il tuo server non riceve informazioni da Classroom.
  • Un insegnante può modificare o eliminare i lavori del corso indipendentemente dallo sviluppatore. Ciò significa che le informazioni sui lavori del corso di uno sviluppatore potrebbero diventare obsolete. Se devi essere a conoscenza delle modifiche ai lavori del corso, valuta la possibilità di configurare le notifiche push per le modifiche ai lavori del corso.
  • Un insegnante può creare lavori del corso nell'interfaccia utente di Classroom con link incollati agli URL del tuo sito web. I lavori del corso creati in questo modo sono di proprietà esclusiva dell'insegnante, pertanto non potrai visualizzare, modificare o impostare i voti per gli invii utilizzando l'API Classroom.