In diesem Dokument werden Konzepte zur Benotung vorgestellt, die für die Classroom API relevant sind.
Im Artikel Aufgaben benoten und verfolgen erfahren Sie mehr über die Abläufe für die Benotung durch Lehrkräfte in der Google Classroom App.
Kursaufgaben und Abgegebene Aufgaben
In Google Classroom geben Schüler/Studenten StudentSubmissions
für die CourseWork
-Aufgaben in ihrem Course
ab. CourseWork
können benotet oder unbenotet sein. Wenn eine CourseWork
benotet wird, hat sie einen maxPoints
-Wert, der angibt, wie viele Punkte die Aufgabe insgesamt wert ist. Wenn maxPoints
= 0 ist oder nicht angegeben ist, wird die Aufgabe als unbenotet gekennzeichnet.
Bei benoteten Aufgaben geben Lehrkräfte eine draftGrade
für die StudentSubmission
an, bevor sie sie an den Schüler/Studenten zurückgeben. Wenn die Einreichung in der Classroom App zurückgegeben wird, wird automatisch eine assignedGrade
für die StudentSubmission
mit demselben Wert wie die aktuelle draftGrade
festgelegt. Entwickler können beide Felder festlegen und müssen das Verhalten der Classroom App emulieren. Beispielsweise kann ein assignedGrade
nicht ohne ein draftGrade
festgelegt werden. Beide Felder werden mit Dezimalstellen dargestellt. Wenn sie nicht festgelegt sind, bedeutet das, dass die Lehrkraft die entsprechende Note noch nicht festgelegt hat.
Unter Noten erstellen und verwalten finden Sie Codebeispiele zum Lesen, Festlegen und Zurückgeben von Noten.
Schüler/Studenten können mehrere Einreichungen für dieselbe CourseWork
-Aufgabe einreichen. Der Status der Einreichung und der Notenverlauf werden in StudentSubmission.submissionHistory
erfasst.
Verspätete, entschuldigte und fehlende Kursarbeit
Wenn CourseWork
-Elemente zugewiesen werden, werden für jeden Schüler oder Studenten PlatzhalterStudentSubmissions
erstellt, auch wenn er nicht mit der entsprechenden Aufgabe interagiert hat. Lehrkräfte können für die CourseWork
ein dueDate
festlegen. Die zugehörigen StudentSubmissions
werden mit einem late
-Feld (true
) gekennzeichnet, wenn der Schüler oder Student die Aufgabe nicht vor dem Datum abgibt. Lehrkräfte können späte Einreichungen auch über eine Einstellung in der Classroom App deaktivieren.
Außerdem werden StudentSubmissions
, die nicht vor dueDate
eingereicht werden, in der Classroom-Benotungsübersicht als fehlend gekennzeichnet. Lehrkräfte können Einreichungen auch manuell in der Classroom App als fehlend markieren. Nicht eingereichte Aufgaben erhalten automatisch die Note draftGrade
, die von der Lehrkraft angepasst werden kann, standardmäßig aber 0 ist.
Fehlende Abgaben können von der Lehrkraft als abgeschlossen oder entschuldigt markiert werden.
Bei als abgeschlossen markierten StudentSubmissions
wird das StandarddraftGrade
-Feld entfernt, bis die Lehrkraft ein neues manuell festlegt. StudentSubmissions
, die als entschuldigt markiert wurden, werden aus der Berechnung der Gesamtnote entfernt, einschließlich Benotungszeiträume.
Im Hilfeartikel Aufgaben benoten und zurückgeben erfahren Sie mehr darüber, wie Lehrkräfte mit Einreichungen umgehen können.
Gesamtnote und Benotungssysteme
Classroom unterstützt mehrere Benotungssysteme für die Berechnung der Gesamtnote der Schüler/Studenten im Kurs. Gesamtnoten können direkt aus der Gesamtpunktzahl, gewichtet nach Kategorie oder gar nicht berechnet werden.
Im Artikel Benotung einrichten finden Sie Informationen zu den verschiedenen Benotungssystemen mit Beispielen.
Einige wichtige Punkte:
- Die Ressource
Course
hat eingradebookSettings
-Objekt mit Details zu den Einstellungen für die Kursnoten.calculationType
gibt die Berechnungsmethode für den Kurs an.displaySettings
gibt an, wer in der Classroom App Noten sehen kann. Es wird empfohlen, diese Best Practice nach Möglichkeit auch in Ihrer eigenen Anwendung zu berücksichtigen. Wenn Schüler/Studenten ihre Gesamtnote beispielsweise nicht in Classroom sehen können, sollten Sie sie ihnen auch nicht in Ihrer App anzeigen.gradeCategories
enthält eine Liste der für den Kurs konfigurierten Benotungskategorien, einschließlich ihrer Anzeigenamen, des Gewichtungsprozentsatzes und der Standardpunkte für die entsprechenden Aufgaben.
- Wenn in einem Kurs eine gewichtete Benotung verwendet wird, müssen Sie die Gewichtungen möglicherweise in Szenarien normalisieren, in denen eine Kategorie nicht vorhanden ist. Wenn die Kategoriegewichte beispielsweise 20% für Hausaufgaben, 10% für Übungsaufgaben und 70% für Quizze betragen, aber keine Übungsaufgaben vorhanden sind, passt Classroom die Gewichte bei der Berechnung der Gesamtnote auf etwa 22% für Hausaufgaben und etwa 78 % für Quizze an. Wenn Sie die Gesamtnoten aus Classroom in Ihrer Bewerbung widerspiegeln möchten, müssen Sie dies auch tun.
Benotungszeiträume
Lehrkräfte können CourseWork
Aufgaben in einem Kurs in verschiedene Zeiträume unterteilen, die als Benotungszeiträume bezeichnet werden. Anhand der Benotungszeiträume können Sie Kursarbeiten in der Notenbuchansicht filtern und separate Bereiche für die Berechnung der Gesamtnote erstellen.
Eine Lehrkraft könnte beispielsweise die Benotungszeiträume „Frühjahr“ und „Herbst“ für das Semester erstellen. Die Gesamtnote für den Frühlingszeitraum würde nur StudentSubmissions
umfassen, die im Frühlingszeitraum fällig sind.
Das für den Kurs festgelegte Benotungssystem gilt auch für die Benotungszeiträume. Wenn also die oben genannten Benotungszeiträume für Frühling und Herbst für einen Kurs festgelegt wurden, in dem gewichtete Benotungskategorien verwendet werden, gibt es letztendlich drei Gesamtnoten für die Schüler/Studenten:
- Die Gesamtnote für alle Aufgaben im Kurs.
- Die Gesamtnote für alle Aufgaben im Frühlingszeitraum.
- Die Gesamtnote für alle Aufgaben im Herbstzeitraum.
Bei allen drei wird die Gesamtnote mit gewichteten Kategorien berechnet.
Eine Übersicht über die Funktion finden Sie in der Mitteilung zu Benotungszeiträumen.
Benotungszeiträume erweitern CourseWork
um ein gradingPeriodId
, das den Benotungszeitraum angibt, in den die Aufgabe fällt.
Im API-Leitfaden zu Benotungszeiträumen erfahren Sie, wie Sie Benotungszeiträume mit der API lesen und verwalten.
Bewertungsschemata
Lehrkräfte können Rubrics
-Bewertungsbögen erstellen und mit CourseWork
-Aufgaben verknüpfen. Diese Bewertungsbögen können dann als Leitfaden bei der Benotung der entsprechenden StudentSubmissions
verwendet werden.
Im Artikel zu Bewertungsrastern erfahren Sie, wie Lehrkräfte Bewertungsraster in Classroom verwenden können.
Rubriken erweitern die StudentSubmissions
-Ressource um zusätzliche Felder:
rubricId
gibt die Benotungsskala an, die derCourseWork
der Einreichung entspricht.draftRubricGrades
steht für die Kriterien und Platzhalternoten, die der Lehrer festgelegt hat, bevor er die Aufgabe an den Schüler/Studenten zurückgegeben hat.assignedRubricGrades
steht für die Kriterien und die Punkte, die der Schüler/Student erhält, nachdem die Lehrkraft die Aufgabe zurückgegeben hat.
Im Leitfaden zur Rubriken API erfahren Sie, wie Sie mit der API Bewertungsraster verwalten und zugehörige Noten abrufen.
Benotungsskalen
Classroom unterstützt anpassbare Benotungsskalen, mit denen Lehrkräfte beispielsweise Noten in Form von Ziffern in Noten in Form von Buchstaben umwandeln können. Diese Einstellungen und die entsprechenden Daten sind in der API nicht verfügbar.