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

Bei der Verwendung der API zur Interaktion mit Bewertungsrastern sind einige wichtige Konzepte zu beachten:

  • 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. Eine Benotungsskala muss immer mindestens ein Kriterium und ein Kriterium immer mindestens eine Stufe 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 werden. Punkte können Ganzzahlen (z. B. 10) oder Gleitkommawerte (z. B. 9,99) sein. Das kann auch 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 benotete Stufen immer nach Punkten in aufsteigender oder absteigender Reihenfolge sortiert werden.
  • Sie können bis zu 50 Kriterien pro Bewertungsschema und bis zu 10 Leistungsstufen pro Kriterium erstellen.

StudentSubmission-Objekte unterstützen Felder für Bewertungsraster:

  • 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 Benotungsskala, die der Schüler/Student im Status „Entwurf“ bzw. „Zugewiesen“ erhält.
  • Diese Properties sind derzeit 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.

Verhalten von Bewertungsschemata

Die API soll nach Möglichkeit der Classroom-Benutzeroberfläche entsprechen, um für Einheitlichkeit zu sorgen. 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.
    • Sie können Punkten für ein Kriterium zuweisen, ohne eine entsprechende Stufe auszuwählen.
    • Die Gesamtpunktzahl der Aufgabe überschreiben, unabhängig von den Punkten, die aus dem Bewertungsschema stammen würden.

Außerdem unterstützt die API kein Verhalten, das nicht bereits in der Classroom-Benutzeroberfläche vorhanden ist. So ist es beispielsweise nicht möglich, die Verwendung von Benotungsrastern für Aufgaben durchzusetzen oder die Möglichkeit von Lehrkräften, Benotungsraster und Einreichungen zu bearbeiten, zu überschreiben.

Einschränkungen bei der Benotung

Außerdem gibt es einige zusätzliche Einschränkungen bei der Bearbeitung von Bewertungsschemata, sobald eine Lehrkraft damit begonnen hat, Noten zu vergeben. Nach dem Starten der Benotung sind nur die folgenden Änderungen möglich:

  • Textänderungen sind für Titel und Beschreibungen von Kriterien und Ebenen 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.

Kurse von Drittanbietern

Bewertungsraster können nur im Google Cloud-Projekt erstellt werden, in dem das übergeordnete CourseWork-Element erstellt wurde. Dies ist ein allgemeineres Designmuster in der Classroom API, das verhindert, dass verschiedene Anwendungen sich auf Ressourcen auswirken, die nicht zu ihnen gehören.

Das gilt auch für Ressourcen, die von Nutzern in der Classroom App erstellt wurden. So ist es beispielsweise nicht möglich, mit einer App Benotungsraster für eine Kursarbeit zu verwalten, die eine Lehrkraft in der Classroom-Benutzeroberfläche erstellt hat, auch wenn die App derselben Lehrkraft gehört. Wenn dies Ihre Nutzung erheblich einschränkt, können Sie uns Feedback im öffentlichen Issue Tracker senden.

Erforderliche Lizenzen

Nutzer können mit der Classroom API nur dann Benotungsraster erstellen, aktualisieren und löschen, wenn die folgenden Bedingungen erfüllt sind:

Unter Voraussetzungen für die Nutzung erfahren Sie mehr darüber, wie API-Funktionen für Nutzer verfügbar gemacht werden. Unter Voraussetzungen für die Classroom API können Sie sich mit der API vertraut machen und ein Demokonto für die Entwicklung anfordern.