Struktur und bekannte Einschränkungen

Wenn Sie mit den Benotungsrastern in Classroom nicht vertraut sind, lesen Sie die Hilfeartikel zur allgemeinen Struktur eines Benotungsrasters und zur Benotung mithilfe von Benotungsrastern in der Classroom-Benutzeroberfläche.

Struktur von Bewertungsschemata

Wenn Sie die API verwenden, um mit Bewertungsschemas zu interagieren, sollten Sie einige wichtige Konzepte hervorheben:

  • Einem CourseWork ist (höchstens) eine einzige Kriterienspalte zugewiesen. Diese Kriterienspalte ist für dieses CourseWork eindeutig und kann nicht für mehrere CourseWork-Ressourcen verwendet werden.
  • Die Benotungsskala besteht aus Kriterien, die aus Stufen bestehen. Ein Bewertungsschema muss immer mindestens ein Kriterium und ein Kriterium immer mindestens eine Ebene haben.
  • Stufen können benotet (Punkte) oder unbenotet (keine Punkte) sein. Die einzelnen Niveaus müssen in einer Benotungsskala entweder vollständig benotet oder vollständig unbenotet sein.
    • Wenn die Stufen bewertet werden, muss für alle Stufen in einem Kriterium ein eindeutiger Punktewert festgelegt sein. Punkte können Ganzzahlen (z. B. 10) oder Gleitkommawerte (z. B. 9,99) sein. Dies kann 0 sein. Nullwerte sind nicht zulässig. Außerdem darf eine Benotungsskala kein einzelnes Kriterium mit einer einzelnen Stufe mit 0 Punkten haben.
    • Wenn die Stufen nicht benotet werden, sollte das Punktefeld weggelassen werden. Nullwerte sind nicht zulässig.
  • Die Reihenfolge der Kriterien und Stufen ist sinnvoll und entspricht der Reihenfolge, in der sie in der Classroom-Benutzeroberfläche dargestellt werden.
    • Insbesondere müssen die bewerteten Level immer nach Punkten in aufsteigender oder abnehmender Reihenfolge sortiert werden.
  • Pro Bewertungsschema können bis zu 50 Kriterien und pro Kriterium bis zu 10 Leistungsstufen festgelegt werden.

Auch von Schülern/Studenten eingereichte Arbeiten werden geändert:

  • Zusätzlich zu den vorhandenen Properties draftGrade und assignedGrade hat eine mit einer Benotungsskala benotete Einreichung von Schülern oder Studenten die Properties draftRubricGrades und assignedRubricGrades. Dies sind die Noten (ausgewählte Stufen und Punkte) aus der Benotungsübersicht, die der Schüler/Student im Status „Entwurf“ bzw. „Zugewiesen“ erhält.
  • Derzeit sind diese Eigenschaften schreibgeschützt. Das bedeutet, dass die API nicht zum Benoten von Einreichungen verwendet werden kann. Sie können jedoch Einreichungen lesen, die in der Classroom-Benutzeroberfläche benotet wurden.
  • Abgegebene Aufgaben mit einem verknüpften Bewertungsschema enthalten das Feld rubricId. Dieses Feld enthält die letzte mit der CourseWork verknüpfte Benotungsskala. Dieser Wert kann sich ändern, wenn Lehrkräfte eine Benotungsskala löschen und neu erstellen.

Verhalten von Bewertungsschemata

Die API soll nach Möglichkeit einheitlich mit der Classroom-Benutzeroberfläche sein. Dies kann jedoch zu einem Verhalten führen, das für Entwickler nicht intuitiv ist. Hier einige Beispiele:

  • Bewertungsraster sollen die Benotung leiten, ohne die Lehrkräfte einzuschränken. So kann eine Lehrkraft bei der Benotung einer Aufgabe mit einer Bewertungsübersicht Folgendes tun:
    • Ignorieren Sie das Bewertungsschema bei der Benotung vollständig.
    • Sie können die Punkte für ein Kriterium unabhängig von den in den Stufen des Kriteriums verfügbaren Punkten überschreiben.
    • Sie können Stufen nur für eine Teilmenge der Kriterien auswählen.
    • Vergeben Sie Punkte für ein Kriterium, ohne ein entsprechendes Level auszuwählen.
    • Sie können die Gesamtpunktzahl der Aufgabe überschreiben, unabhängig von den Punkten, die aus dem Bewertungsschema stammen würden.

Außerdem bietet die API keine neuen Produktfunktionen. Mit anderen Worten: Die API unterstützt keine Funktionen, die nicht bereits in der Classroom-Benutzeroberfläche vorhanden sind. Mit der API lässt sich beispielsweise nicht erzwingen, dass die Benotungsraster für Aufgaben verwendet werden, und die Möglichkeit von Lehrkräften, Benotungsraster und Einreichungen zu bearbeiten, kann nicht überschrieben werden.

Einschränkungen bei der Benotung

Ebenso gibt es einige zusätzliche Einschränkungen beim Bearbeiten von Bewertungsschemas, sobald eine Lehrkraft damit begonnen hat, sie zu benoten. Nach dem Starten der Benotung sind nur die folgenden Änderungen möglich:

  • Textänderungen sind für Kriteriums- und Stufentitel und -beschreibungen zulässig.
  • Die Ebenenreihenfolge kann sich innerhalb der Kriterien ändern.

Zusätzliche Bereiche

Bewertungsraster können manuell nach Google Tabellen exportiert werden, damit sie von Lehrkräften wiederverwendet werden können.

Wenn Sie eine Benotungsskala aus diesen Tabellen erstellen oder aktualisieren (Beispiel im Leitfaden), muss Ihre Anwendung den Umfang https://www.googleapis.com/auth/spreadsheets.readonly oder https://www.googleapis.com/auth/spreadsheets anfordern. Die Bereiche spreadsheets gelten als vertraulich und Ihre App muss möglicherweise überprüft werden.