Struttura delle griglie e limitazioni note

Se non hai dimestichezza 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 le rubriche nell'interfaccia utente di Classroom.

Struttura delle rubriche

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

  • A un CourseWork è associata (al massimo) una singola scheda, che è univoca per quel CourseWork (non è condivisibile tra le risorse CourseWork).
  • La rubrica è composta da criteri, che si suddividono in livelli. Una rubrica deve sempre avere almeno un criterio e un criterio deve sempre avere almeno un livello.
  • I livelli possono essere con punteggio (con punti) o senza punteggio (senza punti). I livelli devono essere completamente valutati o completamente non valutati in una rubrica.
    • Se i livelli sono valutati, tutti i livelli di un criterio devono avere un valore in punti impostato in modo univoco. I punti possono essere numeri interi (ad esempio 10) o valori in virgola mobile (ad esempio 9,99). Può essere incluso 0. I valori null non sono accettati. Inoltre, una rubrica non può avere un unico criterio con un unico livello corrispondente a 0 punti.
    • Se i livelli non sono valutati, il campo 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 relativi alle rubriche:

  • Oltre alle proprietà draftGrade e assignedGrade esistenti, un compito inviato dagli studenti 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 della 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 i compiti inviati, ma puoi leggere i compiti valutati nell'interfaccia utente di Classroom.

Comportamenti delle griglie

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

  • Le rubriche hanno lo scopo di guidare la valutazione senza vincolare gli insegnanti. Di conseguenza, un insegnante può fare quanto segue quando valuta un compito con una rubrica:
    • Ignorare completamente la griglia di valutazione durante la valutazione.
    • Sostituisci i punti di un criterio, indipendentemente da quelli disponibili nei livelli del criterio.
    • Seleziona i livelli solo per un sottoinsieme di criteri.
    • Assegna punti per un criterio senza selezionare un livello corrispondente.
    • Sostituisci i punti totali del compito, indipendentemente dai punti che deriverebbero dalla griglia.

Inoltre, l'API non supporta comportamenti non già presenti nell'interfaccia utente di Classroom. Ad esempio, l'API non consente di applicare l'utilizzo delle rubriche ai compiti o di ignorare la possibilità di un insegnante di modificare le rubriche e i contenuti inviati come accade oggi.

Limitazioni durante la valutazione

Analogamente, esistono alcune limitazioni aggiuntive alla modifica delle griglie una volta che un professore ha iniziato a utilizzarle per assegnare i voti. Dopo aver iniziato a valutare, sono possibili solo le seguenti modifiche:

  • Le modifiche al 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 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 ambitispreadsheets sono considerati sensibili e potrebbero richiedere la verifica della tua app.

Corsi di terze parti

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

Ciò vale anche per le risorse create dagli utenti nell'app Classroom. Ad esempio, non è possibile per un'applicazione gestire le rubriche per un lavoro didattico creato da un insegnante nell'interfaccia utente di Classroom, anche se lo stesso insegnante è il proprietario dell'applicazione. Se ciò limita notevolmente il tuo caso d'uso, condividi un feedback nel tracker dei problemi pubblico.

Requisiti relativi alle licenze

Un utente può creare, aggiornare ed eliminare griglie 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 esposte agli utenti e sui prerequisiti dell'API Classroom per familiarizzare con l'API e richiedere un account demo per lo sviluppo.

Indietro
Periodi di valutazione