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 diesesCourseWork
eindeutig und kann nicht für mehrereCourseWork
-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.
Zugehörige Felder für die Abgabe von Schüler-/Studentenarbeiten
Auch von Schülern/Studenten eingereichte Arbeiten werden geändert:
- Zusätzlich zu den vorhandenen Properties
draftGrade
undassignedGrade
hat eine mit einer Benotungsskala benotete Einreichung von Schülern oder Studenten die PropertiesdraftRubricGrades
undassignedRubricGrades
. 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 derCourseWork
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.