Struttura delle griglie e limitazioni note

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

Struttura delle griglie

Ecco alcuni concetti importanti che potrebbero valere la pena sottolineare quando utilizzi l'API per interagire con le griglie:

  • Esiste al massimo una singola griglia associata a una CourseWork e questa è univoca per CourseWork (non è condivisibile tra CourseWork risorse).
  • La griglia è composta dai criteri, che sono composti da livelli. Una griglia deve avere sempre almeno un criterio e un criterio deve avere sempre almeno un livello.
  • I livelli possono essere valutati (con punti) o senza punteggio (nessun punto). I livelli devono essere interamente valutati o completamente senza punteggio in una griglia.
    • Se viene assegnato un punteggio ai livelli, a tutti i livelli in un criterio deve essere impostato un valore in punti univoco. I punti possono essere numeri interi (come 10) o valori in virgola mobile (come 9,99). Può includere 0. Non sono accettati valori null. Inoltre, una griglia non può avere un singolo criterio con un singolo livello pari a 0 punti.
    • Se i livelli non hanno un punteggio, 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.
    • I livelli con punteggio, in particolare, devono essere sempre ordinati per punti, in ordine crescente o decrescente.
  • Possono essere presenti fino a 50 criteri per griglia e fino a 10 livelli di rendimento per criterio.

Stiamo modificando anche gli oggetti Invio dello studente:

  • Oltre alle proprietà draftGrade e assignedGrade esistenti, un compito di uno studente valutato con una griglia ha le proprietà draftRubricGrades e assignedRubricGrades. Questi rappresentano i voti della griglia (livelli selezionati e valori in punti) che lo studente riceve durante la valutazione dalla griglia, rispettivamente nello stato Bozza e Assegnato.
  • Al momento, queste proprietà sono di sola lettura. Ciò significa che l'API non può essere utilizzata per valutare i contenuti inviati, ma puoi leggere i contributi valutati nella UI di Classroom.
  • I contenuti inviati dallo studente a cui è associata una griglia contengono un campo rubricId. Questo campo rappresenta l'ultima griglia associata a CourseWork e questo valore potrebbe cambiare se gli insegnanti eliminano e ricreano una griglia.

Comportamenti delle griglie

L'API mira a rispecchiare l'UI di Classroom quando possibile per garantire la coerenza, ma questo può portare a comportamenti che potrebbero non essere intuitivi per gli sviluppatori e vale la pena menzionare:

  • Le griglie hanno lo scopo di guidare la valutazione senza vincolare gli insegnanti. Di quindi, un insegnante può fare quanto segue durante la valutazione di un compito con una griglia:
    • Ignori completamente la griglia durante la valutazione.
    • Esegui l'override dei punti per un criterio, indipendentemente dai punti disponibili nei livelli del criterio.
    • Seleziona i livelli solo per un sottoinsieme di criteri.
    • Assegna punti a un criterio senza selezionare un livello corrispondente.
    • Sostituisci i punti totali del compito, indipendentemente dai punti che potrebbero derivare dalla griglia.

Inoltre, l'API non introduce nuove funzionalità del prodotto. In altre parole, l'API non supporta un comportamento che l'interfaccia utente di Classroom non ha già. Ad esempio, l'API non consente di applicare l'utilizzo delle griglie sui compiti o di sovrascrivere la capacità di un insegnante di modificare griglie e contenuti inviati come avviene oggi.

Limitazioni durante la valutazione

Allo stesso modo, una volta che l'insegnante ha iniziato a valutare le griglie, vengono applicate alcune limitazioni aggiuntive. Dopo la valutazione come iniziata, sono possibili solo le seguenti modifiche:

  • Le modifiche di testo sono consentite per i titoli e le descrizioni dei criteri e dei livelli.
  • L'ordinamento dei livelli può cambiare all'interno dei criteri.

Ambiti aggiuntivi

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

Se crei o aggiorni una griglia da questi fogli di lavoro (vedi un esempio nella guida), l'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 verifica della tua applicazione.