Questa pagina elenca alcuni fraintendimenti e casi limite comuni che potresti voler prendere in considerazione nella progettazione e nell'implementazione del componente aggiuntivo di Classroom. Ti consigliamo di implementare misure di sicurezza e test per questi casi.
Concetti di Google Classroom
Questa sezione evidenzia i casi limite e i concetti relativi ai componenti aggiuntivi che si applicano a tutto Google Classroom.
Corsi e ruoli utente
Un corso è l'unità organizzativa centrale che mette in contatto gli insegnanti con studenti. I corsi rappresentano il più alto livello di organizzazione nel API Google Classroom.
Singoli utenti possono essere aggiunti a un corso come "insegnanti" o "studenti". L'account di un utente corso non è legato al suo ruolo nell'istituto. Ciò significa che uno studente della scuola può essere insegnante di un corso e insegnante possono essere studenti dei corsi. Sebbene il caso più comune sia per un corso, per rappresentare una materia accademica regolarmente programmata, i corsi vengono creati anche per organizzare club di studenti o sviluppare lo sviluppo professionale.
Quanto segue si applica a tutti i corsi all'interno di Google Classroom.
Per quanto riguarda gli 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 in streaming
Gli elementi dello stream sono i contenuti pubblicati e condivisi con i membri di un corso. Gli sviluppatori e gli insegnanti possono creare allegati di componenti aggiuntivi su tre elementi dello stream tipi: annunci, compiti e materiali.
Gli insegnanti creano annunci nella parte superiore della pagina Stream della UI di Classroom. Gli insegnanti creano compiti e materiali facendo clic sul pulsante Crea nella scheda Lavori del corso. Gli sviluppatori possono creare questi in modo programmatico tramite l'API Classroom.
Un compito è un elemento dello stream che può accettare i contenuti inviati da uno studente. I compiti sono l'unico tipo di elemento dello stream visualizzato nel registro che può contenere un allegato di un componente aggiuntivo.
Informazioni sugli elementi di streaming:
- È possibile assegnare un compito o materiale a un sottoinsieme di studenti in più avanti in questo corso.
- Un compito potrebbe essere valutato o meno. Gli insegnanti possono modificare la valutazione di un compito in qualsiasi momento.
- Un compito può avere più di un allegato.
- Un compito può avere allegati di tipi diversi. Ad esempio, uno un compito potrebbe avere Documenti Google, video di YouTube e allegati aggiuntivi contemporaneamente.
- Un compito potrebbe avere allegati di componenti aggiuntivi di più sviluppatori.
- Gli sviluppatori possono recuperare e modificare informazioni su qualsiasi elemento dello stream con uno dei seguenti ai relativi allegati.
- Gli sviluppatori possono consegnare, rivendicare o restituire i contenuti inviati da uno studente per un compito che includa uno dei relativi allegati.
- Gli sviluppatori possono impostare i voti solo per i singoli compiti consegnati dagli studenti in i compiti che hanno creato.
Elementi dello stream copiati
Gli insegnanti possono copiare un elemento dello stream copiando un corso, riutilizzando un compito pubblicando un elemento di flusso 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 di un utente, ai membri del corso o a qualsiasi altra iscrizione al di sopra del livello del corso.