Struttura delle griglie e limitazioni note

Se non hai dimestichezza con le griglie di Classroom, consulta questi articoli del Centro assistenza per saperne di più sulla struttura generale di una griglia e su come viene eseguita la classificazione in griglia nell'interfaccia utente di Classroom.

Struttura delle griglie

Ci sono alcuni concetti importanti che potrebbe valere la pena evidenziare quando si utilizza il API per interagire con le griglie:

  • Esiste (al massimo) una singola griglia associata a una CourseWork e questa griglia è univoca per CourseWork (non è condivisibile tra CourseWork risorse).
  • La griglia è composta da criteri, che comprendono livelli. Una griglia deve hanno sempre almeno un criterio e un criterio deve avere sempre almeno di un livello.
  • I livelli possono essere totalizzati (hai punti) o senza punteggio (nessun punto). I livelli devono essere con un punteggio completo o senza punteggio in una griglia.
    • Se ai livelli viene assegnato un punteggio, tutti i livelli di un criterio devono avere un il valore di punti impostato. I punti possono essere numeri interi (come 10) o rappresentazione in virgola mobile (ad es.9,99). Può includere 0. Non sono accettati valori null. Inoltre, una griglia non può avere un singolo criterio con un solo livello vale a dire 0 punti.
    • Se ai livelli non è stato assegnato un punteggio, il campo dei punti deve essere omesso. null valori non accettati.
  • L'ordine dei criteri e dei livelli è significativo e riflette l'ordine in cui sono rappresentati nell'UI di Classroom.
    • In particolare, i livelli di punteggi devono essere sempre ordinati per punti in in ordine crescente o decrescente.
  • Ci possono essere fino a 50 criteri per griglia e fino a 10 livelli di rendimento. per criterio.

Anche gli oggetti inviati dallo studente verranno modificati:

  • Oltre alle proprietà draftGrade e assignedGrade esistenti, un l'invio dello studente valutato con una griglia ha draftRubricGrades e assignedRubricGrades proprietà. che rappresentano i voti delle griglie (livelli) selezionati e in punti) che lo studente riceve durante la valutazione una griglia, rispettivamente nello stato Bozza e Assegnato.
  • Per il 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 contenuti valutati nel UI di Classroom.
  • I compiti degli studenti 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 eseguire il mirroring dell'UI di Classroom quando possibile per garantire la coerenza, ma ciò può portare a comportamenti non intuitivi per gli sviluppatori e vale la pena menzioni:

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

Inoltre, l'API non introdurrà nuove funzionalità del prodotto. In altre l'API non supporta il comportamento di cui l'interfaccia utente di Classroom non ha già. Ad esempio, l'API non abilita l'applicazione forzata dell'utilizzo delle griglie sui compiti sovrascrivere la capacità di un insegnante di modificare le griglie e i contenuti inviati, oggi stesso.

Limitazioni durante la valutazione

Analogamente, esistono ulteriori limiti riguardo alla modifica delle griglie una volta l'insegnante ha iniziato a valutarlo. Sono possibili solo le seguenti modifiche dopo il giorno valutazione come iniziata:

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

Ambiti aggiuntivi

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

Se crei o aggiorni una griglia da questi fogli di lavoro (vedi un esempio nella ), la tua applicazione deve richiedere https://www.googleapis.com/auth/spreadsheets.readonly o Ambito https://www.googleapis.com/auth/spreadsheets. Tieni presente che spreadsheets ambiti sono considerati sensibili e potrebbero richiedere la tua applicazione da verificare.