Questa pagina elenca alcuni malintesi e casi limite comuni che potresti dover prendere in considerazione durante la progettazione e l'implementazione del tuo componente aggiuntivo di Classroom. Ti invitiamo a implementare misure di sicurezza e test che coprano questi casi.
Concetti di Google Classroom
Questa sezione mette in evidenza casi limite e concetti pertinenti ai componenti aggiuntivi che si applicano a tutto Google Classroom.
Corsi e ruoli utente
Un corso è l'unità organizzativa centrale che mette in contatto insegnanti e studenti. I corsi rappresentano il livello più alto di organizzazione nell'API Google Classroom.
I singoli utenti possono essere aggiunti a un corso come "insegnanti" o "studenti". Il ruolo di un utente nel corso non è legato al suo ruolo nel suo istituto. Ciò significa che un abbonamento studenti della scuola può essere un insegnante in un corso e gli abbonati insegnanti possono essere studenti nei corsi. Sebbene il caso più comune sia che un corso representi un argomento accademico regolarmente programmato, i corsi vengono creati anche per organizzare club di studenti o per lo sviluppo professionale.
Quanto segue si applica a tutti i corsi in Google Classroom.
In merito agli insegnanti dei corsi:
- Un corso può avere più di un insegnante.
- Gli insegnanti possono essere aggiunti a un corso in qualsiasi momento.
- Gli insegnanti possono essere rimossi da un corso in qualsiasi momento.
Elemento stream
Gli elementi dello stream sono i contenuti pubblicati condivisi con i membri di un corso. Gli sviluppatori e gli insegnanti possono creare allegati aggiuntivi su tre tipi di elementi dello stream: annunci, compiti e materiali.
Gli insegnanti creano gli annunci nella parte superiore della pagina Stream nell'interfaccia utente di Classroom. Gli insegnanti creano compiti e materiali facendo clic sul pulsante Crea nella scheda Compiti. Gli sviluppatori possono crearli programmaticamente tramite l'API Classroom.
Un compito è un elemento dello stream che può accettare un lavoro inviato dallo studente. I compiti sono l'unico tipo di elemento dello stream visualizzato nel registro che può contenere un allegato del componente aggiuntivo.
In merito agli elementi stream:
- Un compito o un materiale può essere assegnato a un sottoinsieme di studenti del corso.
- Un compito può essere valutato o non valutato. Gli insegnanti possono modificare lo stato di valutazione di un compito in qualsiasi momento.
- Un compito può avere più allegati.
- Un compito può avere allegati di tipi diversi. Ad esempio, un compito può includere contemporaneamente Documenti Google, video di YouTube e allegati di componenti aggiuntivi.
- Un compito potrebbe avere allegati di componenti aggiuntivi di più sviluppatori.
- Gli sviluppatori possono ottenere e modificare le informazioni su qualsiasi elemento dello stream con uno dei loro allegati dei componenti aggiuntivi.
- Gli sviluppatori possono consegnare, recuperare o restituire i contenuti inviati da uno studente per un compito che include uno dei loro allegati del componente aggiuntivo.
- Gli sviluppatori possono impostare i voti solo per i singoli compiti inviati dagli studenti nei compiti che hanno creato.
Elementi stream copiati
Gli insegnanti possono copiare un elemento dello stream copiando un corso, riutilizzando un compito o pubblicando un elemento dello stream in più corsi. Leggi la nostra guida sui contenuti copiati per capire in che modo il componente aggiuntivo può gestire questi scenari.
Istituto dell'utente
L'API Google Classroom non restituisce identificatori per l'istituto, il nucleo didattico o qualsiasi altro appartenenza di un utente al di sopra del livello del corso.