Struttura delle griglie e limitazioni note

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

Struttura delle rubriche

Quando utilizzi l'API per interagire con le rubriche, è importante evidenziare alcuni concetti:

  • A un CourseWork è associata (al massimo) una sola rubrica e questa rubrica è univoca per quel CourseWork (non è condivisibile tra le risorse CourseWork).
  • La rubrica è composta da criteri, che a loro volta sono composti da livelli. Una rubrica deve sempre avere almeno un criterio e un criterio deve sempre avere almeno un livello.
  • I livelli possono avere un punteggio (punti) o non averlo. I livelli devono essere completamente valutati o completamente non valutati in una rubrica.
    • Se i livelli vengono 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 in virgola mobile (ad esempio 9,99). Può includere 0. I valori null non sono accettati. Inoltre, una rubrica non può avere un singolo criterio con un singolo livello che vale 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 con punteggio devono sempre essere ordinati in base ai punti in ordine crescente o decrescente.
  • Possono essere presenti fino a 50 criteri per griglia e fino a 10 livelli di rendimento per criterio.

Gli oggetti StudentSubmission supportano i campi correlati alle rubriche:

  • Oltre alle proprietà draftGrade e assignedGrade esistenti, un compito inviato da 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 negli stati Bozza e Assegnato.
  • Al momento, queste proprietà sono di sola lettura. Ciò significa che l'API non può essere utilizzata per valutare le consegne, ma puoi leggere le consegne valutate nell'interfaccia utente di Classroom.

Comportamenti delle rubriche

L'API mira a rispecchiare la UI di Classroom, ove possibile, per coerenza, ma ciò può portare a un comportamento che potrebbe essere poco intuitivo per gli sviluppatori e vale la pena menzionare:

  • Le rubriche hanno lo scopo di guidare la valutazione senza vincolare gli insegnanti. Di conseguenza, un insegnante può eseguire le seguenti operazioni quando valuta un compito con una rubrica:
    • Ignora completamente la griglia durante la valutazione.
    • Ignora i 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.
    • Ignora il totale dei punti del compito, indipendentemente dai punti che deriverebbero dalla griglia.

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 rubriche per i compiti o di ignorare la possibilità di un insegnante di modificare le rubriche e gli invii come può fare oggi.

Limitazioni durante l'assegnazione del voto

Allo stesso modo, sono previste alcune limitazioni aggiuntive alla modifica delle rubriche una volta che l'insegnante ha iniziato a utilizzarle per assegnare i voti. 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'ordine dei livelli può cambiare all'interno dei criteri.

Ambiti aggiuntivi

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

Se crei o aggiorni una rubrica 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 verifica della tua applicazione.

Corsi di terze parti

Le rubriche 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à.

Ciò vale anche per le risorse create dagli utenti nell'app Classroom. Ad esempio, un'applicazione non può gestire i criteri di valutazione per un compito creato da un insegnante nell'interfaccia utente di Classroom, anche se l'insegnante è proprietario dell'applicazione. Se questo limita in modo significativo il tuo caso d'uso, condividi il tuo feedback nel sistema di monitoraggio dei problemi pubblico.

Requisiti relativi alle licenze

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

Consulta la sezione Idoneità degli utenti per scoprire di più su come le funzionalità dell'API vengono mostrate agli utenti e i prerequisiti dell'API Classroom per acquisire familiarità con un account demo per lo sviluppo e richiederlo.

Indietro
Periodi di valutazione