Struktur und bekannte Einschränkungen

Wenn Sie nicht mit Classroom-Bewertungsschemas vertraut sind, finden Sie in diesen Hilfeartikeln Informationen zur allgemeinen Struktur eines Bewertungsschemas und zur Benotung von Bewertungsschemas in der Classroom-Benutzeroberfläche.

Struktur von Bewertungsschemas

Es gibt einige wichtige Konzepte, die hervorgehoben werden sollten, wenn Sie die API zur Interaktion mit Bewertungsschemas verwenden:

  • Jedem CourseWork ist maximal ein einzelnes Bewertungsschema zugeordnet, das nur für diese CourseWork gilt und kann nicht mit CourseWork-Ressourcen geteilt werden.
  • Das Bewertungsschema besteht aus Kriterien, die sich aus Stufen zusammensetzen. Ein Bewertungsschema muss immer mindestens ein Kriterium enthalten und ein Kriterium muss immer mindestens eine Stufe haben.
  • Level können benotet (mit Punkten) oder unbenotet (keine Punkte) vergeben werden. Die Noten in einer Rubrik müssen entweder vollständig oder gar nicht bewertet werden.
    • Wenn die Stufen bewertet werden, muss für alle Level in einem Kriterium ein eindeutiger Punktwert festgelegt werden. Punkte können Ganzzahlen (z. B. 10) oder Gleitkommawerte (z. B. 9,99) sein. Dieser Wert kann 0 enthalten. Nullwerte sind nicht zulässig. Außerdem darf ein Bewertungsschema kein einzelnes Kriterium mit einer einzelnen Stufe mit 0 Punkten enthalten.
    • Wenn die Stufen nicht bewertet sind, sollte das Punktefeld weggelassen werden. Nullwerte sind nicht zulässig.
  • Die Reihenfolge der Kriterien und Stufen ist aussagekräftig und spiegelt die Reihenfolge wider, in der sie in der Classroom-Benutzeroberfläche dargestellt werden.
    • Insbesondere bewertete Level müssen immer in aufsteigender oder absteigender Reihenfolge nach Punkten sortiert werden.
  • Pro Bewertungsschema können bis zu 50 Kriterien und pro Kriterium bis zu 10 Leistungsstufen festgelegt werden.

Das gilt auch für Objekte für Aufgaben von Schülern/Studenten:

  • Zusätzlich zu den vorhandenen Properties draftGrade und assignedGrade hat eine abgegebene Aufgabe, die mit einem Bewertungsschema benotet wurde, die Properties draftRubricGrades und assignedRubricGrades. Diese stellen die Noten des Bewertungsschemas (ausgewählte Stufen und Punktzahlen) dar, die die Lernenden während der Benotung über das Bewertungsschema im Entwurfsstatus bzw. im Status „Zugewiesen“ erhalten.
  • Diese Eigenschaften sind vorerst schreibgeschützt. Das bedeutet, dass die API nicht zum Benoten von Aufgaben verwendet werden kann. Sie können jedoch abgegebene Aufgaben lesen, die auf der Classroom-Benutzeroberfläche bewertet wurden.
  • Abgegebene Aufgaben mit einem zugehörigen Bewertungsschema enthalten das Feld „rubricId“. Dieses Feld stellt das neueste Bewertungsschema für CourseWork dar. Dieser Wert kann sich ändern, wenn die Lehrkräfte ein Bewertungsschema löschen und neu erstellen.

Verhalten von Bewertungsschemas

Die API versucht, aus Konsistenzgründen die Classroom-Benutzeroberfläche nach Möglichkeit zu spiegeln. Dies kann jedoch zu einem Verhalten führen, das für Entwickler möglicherweise nicht intuitiv und erwähnenswert ist:

  • Mithilfe von Bewertungsschemas können Sie die Benotung steuern, ohne die Lehrkräfte einzuschränken. Lehrkräfte können bei der Benotung einer abgegebenen Aufgabe mit einem Bewertungsschema Folgendes tun:
    • Sie können das Bewertungsschema beim Benoten vollständig ignorieren.
    • Die Punkte eines Kriteriums unabhängig von den verfügbaren Punkten auf den Ebenen des Kriteriums überschreiben.
    • Wählen Sie Ebenen nur für einen Teil der Kriterien aus.
    • Weisen Sie einem Kriterium Punkte zu, ohne ein entsprechendes Level auszuwählen.
    • Die Gesamtpunktzahl der Aufgabe wird unabhängig von den Punkten überschrieben, die aus dem Bewertungsschema abgeleitet werden.

Außerdem werden durch die API keine neuen Produktfunktionen eingeführt. Anders ausgedrückt: Die API unterstützt kein Verhalten, das die Classroom-UI noch nicht hat. Mit der API lässt sich beispielsweise die Verwendung von Bewertungsschemas für Aufgaben nicht erzwingen oder die Möglichkeit einer Lehrkraft, Bewertungsschemas und abgegebene Aufgaben zu bearbeiten, außer Kraft setzen.

Einschränkungen bei der Benotung

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

  • Textänderungen sind für Titel und Beschreibungen von Kriterium und Leveln zulässig.
  • Die Reihenfolge der Ebenen kann sich innerhalb von Kriterien ändern.

Zusätzliche Bereiche

Bewertungsschemas können manuell in Google Tabellen exportiert werden, damit sie von den Lehrkräften wiederverwendet werden können.

Wenn Sie ein Bewertungsschema aus diesen Tabellen erstellen oder aktualisieren (siehe Beispiel in der Anleitung), muss Ihre Anwendung den Bereich https://www.googleapis.com/auth/spreadsheets.readonly oder https://www.googleapis.com/auth/spreadsheets anfordern. Beachten Sie, dass die spreadsheets-Bereiche als vertraulich gelten und möglicherweise eine Verifizierung Ihrer Anwendung erfordern.