Voti

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

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

CourseWork e StudentSubmissions

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

Per i compiti con valutazione, gli insegnanti impostano un voto draftGrade sul StudentSubmission prima di restituirlo allo studente. Quando il compito viene restituito nell'app Classroom, viene impostato automaticamente un assignedGrade sul StudentSubmission, con lo stesso valore dell'draftGrade corrente. Gli sviluppatori possono impostare entrambi questi 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 impostati, implicano che l'insegnante non ha ancora impostato il voto corrispondente. Consulta Creare e gestire i voti per esempi di codice per leggere, impostare e restituire i voti.

Gli studenti possono inviare più invii allo stesso compito CourseWork e lo stato dell'invio e la cronologia dei voti vengono monitorati in StudentSubmission.submissionHistory.

Compiti in ritardo, giustificati e mancanti

Quando vengono assegnati 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 sul CourseWork e i StudentSubmissions associati vengono contrassegnati con un campo late (impostato su true) se lo studente non consegna il compito prima della data. Gli insegnanti possono anche disattivare gli invii in ritardo con un'impostazione nell'app Classroom.

Inoltre, i StudentSubmissions che non vengono consegnati prima delle dueDate sono annotati nel registro di Classroom come mancanti. Gli insegnanti possono anche contrassegnare manualmente gli invii come mancanti nell'app Classroom. Ai compiti mancanti viene assegnato automaticamente un draftGrade, che può essere personalizzato dall'insegnante, ma il valore predefinito è 0.

Gli invii mancanti possono essere contrassegnati come completati o esoneri dall'insegnante. StudentSubmissions contrassegnati come completi hanno il campo draftGrade predefinito rimosso finché l'insegnante non ne imposta uno nuovo manualmente. StudentSubmissions contrassegnati come esonerati vengono rimossi dai calcoli del punteggio complessivo, inclusi i periodi di valutazione.

Consulta l'articolo del Centro assistenza Valutare e restituire un compito per scoprire di più su come gli insegnanti possono gestire gli invii.

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 al totale dei punti, ponderati per categoria o non calcolati affatto.

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

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 per il corso.
  • displaySettings specifica chi può vedere i voti complessivi nell'app Classroom. È una best practice rispettare questa impostazione nella tua applicazione, se possibile. Ad esempio, se gli studenti non riescono a vedere il 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 negli scenari in cui una categoria non è presente. Ad esempio, se i pesi delle categorie erano del 20% per i compiti, del 10% per gli esercizi pratici e del 70% per i quiz, ma in realtà non erano presenti esercizi pratici, Classroom aggiusta i pesi a circa il 22% per i compiti e a circa il 78% per i quiz quando calcola i voti complessivi. Se intendi eseguire il mirroring dei voti complessivi di Classroom nella tua applicazione, devi fare lo stesso.

Periodi di valutazione

Gli insegnanti possono raggruppare i CourseWorkcompiti di un corso in intervalli di date distinti chiamati periodi di valutazione. I periodi di valutazione possono essere utilizzati per filtrare i compiti 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 punteggio complessivo del periodo primaverile includerà solo i StudentSubmissions dovuti nell'intervallo di date primaverile.

Il sistema di valutazione impostato per il corso si estende ai periodi di valutazione. Quindi, se i periodi di valutazione primaverile e autunnale menzionati in precedenza fossero impostati in un corso che utilizzava categorie di valutazione ponderate, alla fine ci sarebbero tre serie 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 della primavera.
• Il voto complessivo per tutti i compiti nell'intervallo di date autunnale.

Tutti e tre calcolerebbero il voto complessivo con categorie ponderate.

Consulta l'annuncio sui periodi di valutazione per una panoramica della 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 utilizzare queste griglie come guida per valutare i StudentSubmissions corrispondenti.

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

Le rubriche estendono la risorsa StudentSubmissions con campi aggiuntivi:

• rubricId identifica i criteri di valutazione che corrispondono al CourseWork dell'invio.
• draftRubricGrades rappresenta i criteri e i punteggi segnaposto che l'insegnante ha bozzato prima di restituire l'invio allo studente.
• assignedRubricGrades rappresenta i criteri e i punteggi che lo studente riceve dopo che l'insegnante restituisce l'invio.

Consulta la guida all'API per le rubriche per scoprire come gestire le rubriche e leggere i voti correlati con l'API.

Scale di valutazione

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