Considerazioni principali

In questa pagina sono elencati alcuni fraintendimenti e casi limite comuni che potrebbe essere utile prendere in considerazione durante la progettazione e l'implementazione del componente aggiuntivo di Classroom. Ti consigliamo di implementare misure di sicurezza e test per questi casi.

Concetti di Google Classroom

Questa sezione mette in evidenza casi limite e concetti pertinenti ai componenti aggiuntivi che si applicano all'intero Google Classroom.

Corsi e ruoli utente

Un corso è l'unità organizzativa centrale che collega gli insegnanti agli studenti. I corsi sono i più alti livelli di organizzazione nell'API Google Classroom.

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 uno studente membro della scuola può essere un insegnante di un corso e che i membri di un insegnante possono essere studenti dei corsi. Sebbene il caso più comune sia quando un corso rappresenta una materia accademica regolarmente programmata, i corsi vengono creati anche per organizzare club di studenti o condurre uno 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. Sviluppatori e insegnanti possono creare allegati di componenti aggiuntivi su tre tipi di elementi dello stream: annunci, compiti e materiali.

Gli insegnanti creano gli annunci nella parte superiore della pagina Stream dell'interfaccia utente di Classroom. Per creare compiti e materiali, gli insegnanti fanno clic sul pulsante Crea nella scheda Lavori del corso. Gli sviluppatori possono crearli 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 aggiuntivo.

Informazioni sugli elementi di streaming:

  • È possibile assegnare un compito o materiale a un sottoinsieme degli studenti del corso.
  • Un compito potrebbe essere valutato o meno. Gli insegnanti possono cambiare lo stato di 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, un compito potrebbe 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 recuperare e modificare informazioni su qualsiasi elemento dello stream con uno dei loro allegati dei componenti aggiuntivi.
  • Gli sviluppatori possono consegnare, rivendicare o restituire i contenuti inviati da uno studente per un compito che include uno degli allegati dei componenti aggiuntivi.
  • Gli sviluppatori possono impostare i voti solo per i singoli compiti consegnati dagli studenti.

Elementi dello 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 ai contenuti copiati per capire in che modo il componente aggiuntivo è in grado di gestire questi scenari.

Istituto dell'utente

L'API Google Classroom non restituisce identificatori per l'istituto, l'edificio o qualsiasi altro abbonamento di un utente al di sopra del livello del corso.