Voti

Questo documento introduce i concetti di valutazione pertinenti all'API Classroom.

Leggi l'articolo Valutare e monitorare i compiti per scoprire di più sui percorsi di valutazione degli insegnanti nell'app Google Classroom.

Attività del corso e contenuti inviati

In Google Classroom, gli studenti consegnano StudentSubmissions per i compiti di CourseWork nella loro Course. CourseWork può essere valutato o senza voto. Se un CourseWork è valutato, ha un valore maxPoints che rappresenta il numero totale di punti del compito. Se maxPoints è pari a zero o non è specificato, il compito non viene valutato.

Per i compiti valutati, gli insegnanti impostano un voto draftGrade nella StudentSubmission prima di restituirlo allo studente. Quando l'invio viene riportato nell'app Classroom, un assignedGrade viene impostato automaticamente sul StudentSubmission, con lo stesso valore dell'draftGrade corrente. Gli sviluppatori possono impostare entrambi i campi e devono emulare il comportamento dell'app Classroom. Ad esempio, un assignedGrade non può essere impostato senza un draftGrade. Entrambi i campi sono rappresentati con numeri decimali e, se non sono impostati, implicano che l'insegnante non ha ancora impostato il voto corrispondente. Per esempi di codice per la lettura, l'impostazione e il ritorno dei voti, consulta Creare e gestire i voti.

Gli studenti possono inviare più versioni dello stesso compito CourseWork e lo stato di invio e la cronologia dei voti vengono monitorati in StudentSubmission.submissionHistory.

Lavori in ritardo, giustificati e mancanti

Quando vengono assegnati gli elementi CourseWork, vengono creati segnaposto StudentSubmissions per ogni studente, anche se lo studente non ha interagito con il compito corrispondente. Gli insegnanti possono impostare un dueDate in CourseWork e gli StudentSubmissions associati sono contrassegnati con un campo late (impostato su true) se lo studente non consegna il compito prima della data. Gli insegnanti possono anche disattivare l'invio in ritardo con un'impostazione nell'app Classroom.

Inoltre, i StudentSubmissions che non vengono inviati prima del giorno dueDate sono помечены в журнале оценок Classroom come mancanti. Gli insegnanti possono anche contrassegnare manualmente i contenuti inviati come mancanti nell'app Classroom. I compiti mancanti vengono assegnati automaticamente un draftGrade, che è personalizzabile dall'insegnante, ma per impostazione predefinita è pari a 0.

I compiti mancanti possono essere contrassegnati come completati o esonerati dall'insegnante. Il campo draftGrade predefinito viene rimosso dai StudentSubmissions contrassegnati come completati finché l'insegnante non ne imposta uno nuovo manualmente. I StudentSubmissions contrassegnati come esonerati vengono rimossi dai calcoli del punteggio complessivo, inclusi i periodi di valutazione.

Nota: gli stati completi, mancanti e giustificati di StudentSubmissions non sono distintamente identificabili nell'API. Se questo comportamento influisce sulla tua applicazione, lascia un feedback in questo problema descrivendo l'impatto sul tuo caso d'uso.

Consulta l'articolo del Centro assistenza Valutare e restituire un compito per ulteriori informazioni su come gli insegnanti possono gestire i contenuti inviati.

Voto complessivo e sistemi di valutazione

Classroom supporta più sistemi di valutazione per calcolare i voti complessivi degli studenti nel corso. I voti complessivi possono essere calcolati direttamente in base ai punti totali, ponderati per categoria o non calcolati affatto.

Consulta l'articolo Configurare la valutazione per scoprire di più sui diversi sistemi di valutazione con esempi.

Ecco alcuni punti chiave:

• La risorsa Course ha un oggetto gradebookSettings con i dettagli sulle impostazioni del voto del corso.
  • calculationType specifica il metodo di calcolo del corso.
  • displaySettings specifica chi può vedere i voti complessivi nell'app Classroom. Una best practice consiste nel rispettare questo aspetto nella tua applicazione se possibile. Ad esempio, se gli studenti non possono vedere il loro voto complessivo in Classroom, non mostrarlo nella tua app.
  • gradeCategories contiene un elenco delle categorie di valutazione configurate per il corso, inclusi i nomi visualizzati, la percentuale di ponderazione e i punti predefiniti per i compiti corrispondenti.
• Se un corso utilizza la valutazione ponderata, potrebbe essere necessario normalizzare i pesi in scenari in cui non è presente una categoria. Ad esempio, se la ponderazione delle categorie era 20% per i compiti, 10% per le esercitazioni e 70% per i quiz, ma in realtà non erano presenti esercitazioni, Classroom regola le ponderazioni su ~22% per i compiti e ~78% per i quiz al momento di calcolare i voti complessivi. Se intendi rispecchiare i voti complessivi di Classroom nella tua applicazione, devi fare lo stesso.

Periodi di valutazione

Gli insegnanti possono raggruppare CourseWork compiti in un corso in intervalli di date distinti chiamati periodi di valutazione. I periodi di valutazione possono essere utilizzati per filtrare il lavoro svolto dagli studenti nella visualizzazione del registro e creare bucket distinti per i calcoli del voto complessivo.

Ad esempio, un insegnante potrebbe creare periodi di valutazione per i semestri "primavera" e "autunno". Il voto complessivo per il periodo primaverile include soloStudentSubmissions due nell'intervallo di date primaverili.

Il sistema di valutazione impostato per il corso si estende ai periodi di valutazione. Pertanto, se i periodi di valutazione primaverili e autunnali di cui sopra fossero impostati su un corso che utilizza categorie di valutazione ponderate, alla fine ci sarebbero tre insiemi di voti complessivi per gli studenti:

• Il voto complessivo per tutti i compiti del corso.
• Il voto complessivo per tutti i compiti nell'intervallo di date primaverile.
• Il voto complessivo per tutti i compiti nell'intervallo di date autunnali.

In tutti e tre i casi, il voto complessivo viene calcolato con categorie ponderate.

Consulta l'annuncio relativo ai periodi di valutazione per avere una panoramica della funzionalità.

Anteprima per sviluppatori: il supporto dell'API per i periodi di valutazione è disponibile nell'ambito del Programma Anteprima per sviluppatori di Google Workspace, che concede l'accesso in anteprima a determinate funzionalità.

I periodi di valutazione si estendono a CourseWork con un gradingPeriodId che identifica il periodo di valutazione in cui rientra il compito.

Consulta la guida all'API per i periodi di valutazione per scoprire come leggere e gestire i periodi di valutazione con l'API.

Griglie

Gli insegnanti possono creare e associare Rubrics ai compiti CourseWork e usare queste griglie come guida per valutare i StudentSubmissions corrispondenti.

Consulta l'articolo sulle rubriche per scoprire come gli insegnanti possono utilizzarle in Classroom.

Anteprima per sviluppatori: il supporto dell'API per le rubriche è disponibile nell'ambito del Programma Anteprima per sviluppatori di Google Workspace, che concede l'accesso in anteprima a determinate funzionalità.

Le rubriche estendono la risorsa StudentSubmissions con campi aggiuntivi:

• rubricId identifica la griglia che corrisponde al CourseWork per i contenuti inviati.
• draftRubricGrades indica i criteri e i punteggi segnaposto che l'insegnante ha creato prima di restituire il compito allo studente.
• assignedRubricGrades indica i criteri e i punteggi che lo studente riceve dopo che l'insegnante restituisce i contenuti inviati.

Per informazioni su come gestire le griglie e leggere i voti correlati con l'API, consulta la guida all'API delle griglie.

Scale di valutazione

Classroom supporta scale di valutazione personalizzabili, ad esempio, che consentono agli insegnanti di tradurre i voti numerici in voti in lettere. Queste impostazioni e i dati corrispondenti non sono disponibili nell'API.