Struttura delle griglie e limitazioni note

Se non hai familiarità con le griglie di valutazione di Classroom, consulta questi articoli del Centro assistenza per scoprire la struttura generale di una griglia e come viene eseguita la valutazione con le griglie nell' interfaccia utente di Classroom.

Struttura delle griglie di valutazione

Quando utilizzi l'API per interagire con le griglie di valutazione, è importante tenere presente alcuni concetti:

  • A un CourseWork è associata (al massimo) una singola griglia di valutazione, e quella griglia di valutazione è univoca per quel CourseWork (non è condivisibile tra le risorse CourseWork).
  • La griglia di valutazione è composta da criteri, che a loro volta sono composti da livelli. Una griglia di valutazione deve sempre avere almeno un criterio e un criterio deve sempre avere almeno un livello.
  • I livelli possono essere valutati (con punti) o non valutati (senza punti). I livelli di una griglia di valutazione devono essere interamente valutati o interamente non valutati.
    • Se i livelli sono valutati, tutti i livelli di un criterio devono avere un valore in punti univoco. I punti possono essere numeri interi (ad esempio 10) o valori a virgola mobile (ad esempio 9,99). Può essere incluso anche 0. I valori null non sono accettati. Inoltre, una griglia di valutazione non può avere un singolo criterio con un singolo livello di 0 punti.
    • Se i livelli non sono valutati, il campo dei punti deve essere omesso; i valori null non sono accettati.
  • L'ordine dei criteri e dei livelli è significativo e riflette l'ordine in cui sono rappresentati nell'interfaccia utente di Classroom.
    • In particolare, i livelli valutati devono essere sempre ordinati per punti in ordine crescente o decrescente.
  • Possono essere presenti fino a 50 criteri per griglia di valutazione e fino a 10 livelli di rendimento per criterio.

StudentSubmission oggetti supportano i campi relativi alle griglie di valutazione:

  • Oltre alle proprietà draftGrade e assignedGrade esistenti, un compito consegnato da uno studente valutato con una griglia di valutazione ha le proprietà draftRubricGrades e assignedRubricGrades. Queste rappresentano i voti della griglia di valutazione (livelli selezionati e valori in punti) che lo studente riceve durante la valutazione dalla griglia, rispettivamente negli stati di bozza e assegnato.
  • Per il momento, queste proprietà sono di sola lettura. Ciò significa che l'API non può essere utilizzata per valutare i compiti consegnati, ma puoi leggere i compiti consegnati valutati nell' interfaccia utente di Classroom.

Comportamenti delle griglie di valutazione

L'API mira a rispecchiare l'interfaccia utente di Classroom ogni volta che è possibile per garantire la coerenza, ma ciò può portare a un comportamento che potrebbe non essere intuitivo per gli sviluppatori e che vale la pena menzionare:

  • Le griglie di valutazione hanno lo scopo di guidare la valutazione senza vincolare gli insegnanti. Di conseguenza, un insegnante può eseguire le seguenti operazioni quando valuta un compito consegnato con una griglia di valutazione:
    • Ignorare completamente la griglia di valutazione durante la valutazione.
    • Ignorare i punti di un criterio, indipendentemente dai punti disponibili nei livelli del criterio.
    • Selezionare i livelli solo per un sottoinsieme di criteri.
    • Assegnare punti a un criterio senza selezionare un livello corrispondente.
    • Ignorare il totale dei punti del compito, indipendentemente dai punti che deriverebbero dalla griglia di valutazione.

Inoltre, l'API non supporta comportamenti che l'interfaccia utente di Classroom non ha già. Ad esempio, l'API non consente di applicare l'utilizzo delle griglie di valutazione ai compiti o di ignorare la possibilità di un insegnante di modificare le griglie di valutazione e i compiti consegnati come può fare oggi.

Limitazioni durante la valutazione

Allo stesso modo, esistono alcune limitazioni aggiuntive alla modifica delle griglie di valutazione una volta che un insegnante ha iniziato a valutarle. Dopo l'inizio della valutazione, sono possibili solo le seguenti modifiche:

  • Sono consentite modifiche del testo per i titoli e le descrizioni dei criteri e dei livelli.
  • L'ordinamento dei livelli può essere modificato all'interno dei criteri.

Ambiti aggiuntivi

Le griglie di valutazione possono essere manualmente esportate in Fogli Google per essere riutilizzate dagli insegnanti.

Se crei o aggiorni una griglia di valutazione da questi fogli di lavoro (vedi un esempio nella guida), la tua applicazione deve richiedere l'ambito https://www.googleapis.com/auth/spreadsheets.readonly o https://www.googleapis.com/auth/spreadsheets. Tieni presente che gli ambiti spreadsheets sono considerati sensibili e potrebbero richiedere la tua applicazione per essere verificata.

Compiti di terze parti

Le griglie di valutazione possono essere create solo dal progetto Google Cloud che ha creato l'elemento CourseWork principale. Si tratta di un pattern di progettazione più ampio nell'API Classroom che impedisce a diverse applicazioni di influire su risorse che non sono di loro proprietà.

Questo vale anche per le risorse create dagli utenti nell'app Classroom. Ad esempio, un'applicazione non può gestire le griglie di valutazione per un compito che un insegnante ha creato nell'interfaccia utente di Classroom, anche se lo stesso insegnante è proprietario dell'applicazione. Se questo limita in modo significativo il tuo caso d'uso, condividi il tuo feedback nello strumento Issue Tracker pubblico.

Requisiti relativi alle licenze

Un utente può creare, aggiornare ed eliminare le griglie di valutazione con l'API Classroom solo se sono soddisfatte le seguenti condizioni:

Per scoprire di più su come le funzionalità dell'API vengono esposte agli utenti e sui prerequisiti dell'API Classroom, consulta la pagina Idoneità degli utenti e richiedi un account demo per lo sviluppo.

Indietro
Periodi di valutazione