Wenn Sie mit Bewertungsschemas in Classroom nicht vertraut sind, finden Sie in diesen Hilfeartikeln Informationen zu r allgemeinen Struktur eines Bewertungsschemas und dazu, wie die Bewertung mit Bewertungsschemas in der Classroom-UI erfolgt.
Struktur von Bewertungsschemas
Bei der Verwendung der API zur Interaktion mit Bewertungsschemas gibt es einige wichtige Konzepte, die Sie kennen sollten:
- Einem
CourseWork-Objekt ist (maximal) ein einzelnes Bewertungsschema zugeordnet, das für diesesCourseWorkeindeutig ist. Es kann nicht für andereCourseWork-Ressourcen freigegeben werden. - Das Bewertungsschema besteht aus Kriterien, die wiederum aus Stufen bestehen. Ein Bewertungsschema muss immer mindestens ein Kriterium und ein Kriterium muss immer mindestens eine Stufe haben.
- Stufen können bewertet werden (mit Punkten) oder nicht bewertet werden (ohne Punkte). In einem Bewertungsschema müssen alle Stufen entweder bewertet oder nicht bewertet sein.
- Wenn die Stufen bewertet werden, muss für alle Stufen in einem Kriterium ein eindeutiger Punktwert festgelegt sein. Punkte können ganze Zahlen (z. B. 10) oder Gleitkommawerte (z. B. 9,99) sein. Auch 0 ist möglich. Nullwerte sind nicht zulässig. Außerdem darf ein Bewertungsschema kein einzelnes Kriterium mit einer einzelnen Stufe mit 0 Punkten haben.
- Wenn die Stufen nicht bewertet werden, muss das Feld „Punkte“ weggelassen werden. Nullwerte sind nicht zulässig.
- Die Reihenfolge der Kriterien und Stufen ist wichtig und entspricht der Reihenfolge, in der sie in der Classroom-UI dargestellt werden.
- Bewertete Stufen müssen immer nach Punkten sortiert sein, entweder aufsteigend oder absteigend.
- Es können bis zu 50 Kriterien pro Bewertungsschema und bis zu 10 Leistungsstufen pro Kriterium erstellt werden.
Zugehörige Felder für abgegebene Aufgaben
StudentSubmission -Objekte unterstützen Felder im Zusammenhang mit Bewertungsschemas:
- Neben den vorhandenen Eigenschaften
draftGradeundassignedGradehat eine mit einem Bewertungsschema bewertete abgegebene Aufgabe die EigenschaftendraftRubricGradesundassignedRubricGrades. Diese stellen die Bewertungsschemanoten (ausgewählte Stufen und Punktwerte) dar, die der Schüler/Student bei der Bewertung mit dem Bewertungsschema erhält, und zwar im Entwurfs- bzw. zugewiesenen Status. - Derzeit sind diese Eigenschaften schreibgeschützt. Das bedeutet, dass die API nicht zum Bewerten von abgegebenen Aufgaben verwendet werden kann. Sie können aber in der Classroom-UI bewertete abgegebene Aufgaben lesen.
Verhalten von Bewertungsschemas
Die API soll die Classroom-UI möglichst genau widerspiegeln, um Konsistenz zu gewährleisten. Dies kann jedoch zu einem Verhalten führen, das für Entwickler möglicherweise nicht intuitiv ist und daher erwähnt werden sollte:
- Bewertungsschemas sollen die Bewertung leiten, ohne die Lehrkräfte einzuschränken. Daher kann eine Lehrkraft beim Bewerten einer abgegebenen Aufgabe mit einem Bewertungsschema Folgendes tun:
- Das Bewertungsschema bei der Bewertung vollständig ignorieren.
- Die Punkte für ein Kriterium überschreiben, unabhängig von den Punkten, die in den Stufen des Kriteriums verfügbar sind.
- Stufen nur für eine Teilmenge der Kriterien auswählen.
- Punkte für ein Kriterium zuweisen, ohne eine entsprechende Stufe auszuwählen.
- Die Gesamtpunktzahl der Aufgabe überschreiben, unabhängig von den Punkten, die sich aus dem Bewertungsschema ergeben würden.
Außerdem unterstützt die API kein Verhalten, das in der Classroom-UI noch nicht vorhanden ist. Beispielsweise kann mit der API nicht die Verwendung von Bewertungsschemas für Aufgaben erzwungen oder die Möglichkeit einer Lehrkraft überschrieben werden, Bewertungsschemas und abgegebene Aufgaben so zu bearbeiten, wie es derzeit möglich ist.
Einschränkungen bei der Bewertung
Ebenso gibt es einige zusätzliche Einschränkungen für die Bearbeitung von Bewertungsschemas, sobald eine Lehrkraft mit der Bewertung begonnen hat. Nach Beginn der Bewertung sind nur die folgenden Änderungen möglich:
- Textbearbeitungen sind für Kriterien- und Stufentitel und ‑beschreibungen zulässig.
- Die Reihenfolge der Stufen kann sich innerhalb der Kriterien ändern.
Zusätzliche Bereiche
Bewertungsschemas können manuell exportiert in Google-Tabellen exportiert werden, damit sie von Lehrkräften wiederverwendet werden können.
Wenn Sie ein Bewertungsschema aus diesen Tabellen erstellen oder aktualisieren (siehe ein Beispiel in der
Anleitung), muss Ihre Anwendung den Bereich
https://www.googleapis.com/auth/spreadsheets.readonly oder
https://www.googleapis.com/auth/spreadsheets anfordern. Die Bereiche für
spreadsheets gelten als vertraulich und erfordern möglicherweise eine Überprüfung Ihrer Anwendung
zuwerden.
Kursaufgaben von Drittanbietern
Bewertungsschemas können nur vom Google Cloud-Projekt erstellt werden, mit dem das übergeordnete CourseWork-Element erstellt wurde. Dies ist ein allgemeineres Designmuster in der Classroom API, das verhindert, dass verschiedene Anwendungen Ressourcen beeinflussen, die nicht ihnen gehören.
Dies gilt auch für Ressourcen, die von Nutzern in der Classroom App erstellt wurden. Beispielsweise ist es für eine Anwendung nicht möglich, Bewertungsschemas für eine Aufgabe zu verwalten, die eine Lehrkraft in der Classroom-UI erstellt hat, auch wenn die Lehrkraft Eigentümer der Anwendung ist. Wenn dies Ihren Anwendungsfall erheblich einschränkt, geben Sie Feedback in der öffentlichen Problemverfolgung.
Erforderliche Lizenzen
Ein Nutzer kann Bewertungsschemas nur mit der Classroom API erstellen, aktualisieren und löschen, wenn die folgenden Bedingungen erfüllt sind:
- Dem Nutzer, der die Anfrage stellt, ist eine Google Workspace for Education Plus-Lizenz zugewiesen.
- Dem Kursinhaber des entsprechenden Kurses ist eine Google Workspace for Education Plus-Lizenz zugewiesen.
Unter Nutzerberechtigung erfahren Sie mehr darüber, wie API Funktionen für Nutzer verfügbar gemacht werden. Unter Voraussetzungen für die Classroom API finden Sie Informationen zu einem Demokonto für die Entwicklung und wie Sie es anfordern können.