Einführung

Aufgaben in Classroom werden als „Kursaufgaben“ bezeichnet und sind auf der Seite „Kursaufgaben“ eines beliebigen Classroom-Kurses zu finden. Es gibt vier Arten von Kursaufgaben, in diesem Leitfaden geht es jedoch nur um den Typ „Aufgabe“. Informationen zum Verwalten der anderen Arten von Kursaufgaben finden Sie in unserem Leitfaden Kursaufgaben verwalten.

Google Classroom bietet zwei Möglichkeiten zur Integration in einen Aufgabenworkflow: die Schaltfläche „Mit Classroom teilen“ und die Classroom API. Mit der Schaltfläche „Teilen“ können Nutzer Inhalte als beliebige Stream-Elemente über ein Classroom-Pop-up-Fenster teilen. Mit der Classroom API lässt sich ein vollständiger Aufgabenworkflow erstellen, der das Erstellen von Aufgaben, das Erstellen und Verwalten von abgegebenen Aufgaben und die Rückgabe von Noten umfasst.

Hier sehen wir uns die wichtigsten Unterschiede zwischen diesen beiden Angeboten für Entwickler an. Insbesondere werden wir die Unterschiede bei der Implementierung und in jeder Phase des Aufgabenlebenszyklus durchgehen: Erstellung von Aufgaben, Abgabe von Aufgaben durch Schüler/Studenten und Benotung/Feedback.

Aufgabenlebenszyklus

Bevor wir uns die Unterschiede zwischen der Schaltfläche „Teilen“ und der CourseWork API ansehen, definieren wir zunächst, was wir im Zusammenhang mit Classroom als Lebenszyklus einer Aufgabe betrachten. So können Sie besser verstehen, wie Lehrkräfte und Schüler/Studenten mit Aufgaben in Classroom interagieren.

Bei der Integration mit Classroom-Aufgaben sind fünf Hauptschritte zu beachten:

1. Aufgabe wird erstellt.
2. Aufgabe wird mit Schülern/Studenten geteilt.
3. Schüler/Student bearbeitet die Aufgabe.
4. Schüler/Student gibt die Aufgabe an die Lehrkraft ab.
5. Lehrkraft überprüft und benotet die Aufgabe.

Durch die Integration mit Classroom-Aufgaben können Lehrkräfte und Schüler/Studenten nahtlos zwischen Classroom und Drittanbieteranwendungen wechseln. Anstatt die Details einer Aufgabe oder die Abgaben von Schülern/Studenten zu verwalten, können sich Nutzer darauf verlassen, dass Ihre Anwendung diese Details für sie verwaltet.

Implementierung

Der erste Unterschied zwischen der Schaltfläche „Teilen“ und der CourseWork API ist die Implementierung. Aus Entwicklersicht ist die Schaltfläche „Teilen“ eine einfachere Methode zum Teilen von Inhalten in Classroom, da nur die erforderliche JavaScript-Ressource eingebunden und ein Tag für die Schaltfläche „Teilen“ hinzugefügt werden muss. In der einfachsten Form kann die Integration der Schaltfläche „Mit Classroom teilen“ so aussehen:

<script src="https://apis.google.com/js/platform.js" async defer></script>
<g:sharetoclassroom url="http://url-to-share" size="32"></g:sharetoclassroom>

Weitere Informationen zur Integration mit der Schaltfläche „Teilen“ hier.

Die CourseWork API ist hingegen Teil der Google Classroom API REST API. Dazu müssen API-Schlüssel mit der Google Cloud Console eingerichtet und aktiviert werden. Außerdem müssen die Best Practices für die Integration mit einer API eingehalten werden. Das ist weniger problematisch , wenn Ihre Plattform bereits andere Funktionen der Classroom API nutzt, z. B. die Teilnehmerliste.

Aufgaben erstellen und teilen

Mit der Schaltfläche „Teilen“ und der CourseWork API lassen sich die ersten beiden Schritte des Aufgabenworkflows ausführen: Erstellen und Teilen der Aufgabe mit Schülern/Studenten. Es gibt jedoch einige wichtige Unterschiede, die Sie berücksichtigen sollten, bevor Sie sich für eine Lösung entscheiden.

Beide Lösungen ermöglichen das Posten von Links oder Dateien als Aufgaben in Classroom. Das ist ein leistungsstarker Workflow für Lehrkräfte, die sonst Inhalte zwischen Classroom und der Drittanbieteranwendung kopieren und einfügen müssten. Beide Lösungen unterstützen das Posten von Inhalten als Aufgabe. Sie sollten jedoch überlegen, ob Ihre Anwendung die Flexibilität benötigt, diese Inhalte als andere Arten von Kursaufgaben oder sogar als Ankündigung zu posten.

Beide Angebote stellen alle Arten von Classroom-Beiträgen außer Quizaufgaben zur Verfügung. Eine Zusammenfassung aller Beitragstypen und Informationen dazu, ob sie verfügbar sind, finden Sie unten.

Beitragstyp	Button „Teilen“	CourseWork API
Aufgabe	X	X
Quizaufgabe
Frage: Kurzantwort	X	X
Frage: Multiple-Choice-Frage	X	X
Material	X	X
Ankündigung	X	X

Funktionen wie das Festlegen von Titel und Beschreibung können für beide Lösungen auch programmatisch von Ihrer Anwendung angegeben werden. Bei der Integration der Schaltfläche „Teilen“ können Nutzer Felder wie Abgabetermin, Thema, individueller Modus und Anzahl der Punkte im Pop-up-Fenster festlegen. Diese Felder können jedoch nicht programmatisch von einer Drittanbieter-App festgelegt werden. Die API hingegen stellt alle diese Felder für den Lese- und Schreibzugriff zur Verfügung.

Mit der Schaltfläche „Teilen“ kann Ihre Anwendung auch keine Felder angeben, die für Fragetypen spezifisch sind, z.B. Multiple-Choice-Optionen.

Aufgaben ändern

Einer der Vorteile der Integration mit der Classroom API besteht darin, dass Nutzer die Details ihrer Aufgaben nicht manuell synchronisieren müssen. Die Schaltfläche „Teilen“ bietet keine Funktion zum programmatischen Aktualisieren oder Löschen von Aufgaben. Alle erforderlichen Änderungen müssen vom Nutzer über die Classroom-UI vorgenommen werden.

Mit der CourseWork API können Sie sowohl Aufgaben ändern als auch löschen, die von Ihrer Anwendung erstellt wurden. Außerdem können Sie Details zu allen Aufgaben abrufen, die in den Kursen des Nutzers gepostet wurden. Es ist jedoch wichtig zu beachten, dass Kursaufgaben, die nicht über dieselbe Developer Console erstellt wurden, nicht über diese Developer Console geändert werden können. Dieses Berechtigungsmodell gilt auch für den Rest des Aufgabenlebenszyklus. So kann beispielsweise nicht auf die Verwaltung von Abgaben und Noten von Schülern/Studenten für diese Kursaufgaben zugegriffen werden.

Aufgaben automatisch synchronisieren

Mit Pub/Sub Push-Benachrichtigungen, kann Ihre Anwendung Benachrichtigungen abonnieren, die ein Ereignis auslösen, wenn sich Kursaufgaben und die zugehörigen Abgaben von Schülern/Studenten ändern. So können Sie Aufgaben ganz einfach synchronisieren, da Sie nicht ständig prüfen müssen, ob Inhalte in Classroom aktualisiert wurden.

Aufgaben bearbeiten und abgeben

Jede Aufgabe ist mit N Abgaben von Schülern/Studenten verknüpft, wobei N die Anzahl der Schüler/Studenten ist, denen die Aufgabe zugewiesen wurde. Mit anderen Worten: Für jede Aufgabe gibt es eine Abgabe von Schülern/Studenten für jeden Schüler/Studenten, auf die mit einer eindeutigen ID zugegriffen werden kann. Diese Abgaben von Schülern/Studenten werden automatisch erstellt und können von Ihrer Anwendung mit den GET- und LIST-Endpunkten für Abgaben von Schülern/Studenten abgerufen werden.

Sowohl die Schaltfläche „Teilen“ als auch die CourseWork API unterstützen das Hinzufügen von Links oder Dateien zur Abgabe eines Schülers/Studenten für eine Aufgabe. Mit der Schaltfläche „Teilen“ ist dies über einen ähnlichen Workflow wie im Dialogfeld zum Erstellen von Aufgaben für Lehrkräfte möglich. Mit der CourseWork API ist dies über den studentSubmissions.modifyAttachments möglich. Aufgrund der oben beschriebenen Einschränkungen der API-Berechtigungen ist diese Funktion jedoch auf Kursaufgaben beschränkt, die von Ihrer Anwendung erstellt wurden. Diese Einschränkung gilt nicht für die Schaltfläche „Teilen“. Schüler/Studenten können ihre Arbeit zu jeder Aufgabe hinzufügen, die sie in Classroom auswählen.

Workflow für Schüler/Studenten beenden

Die Einschränkung der CourseWork-Berechtigungen ist zwar nicht für Plattformen geeignet, die das Erstellen von Aufgaben nicht unterstützen, aber ein Vorteil ist, dass Drittanbieterplattformen verhindern können, dass Schüler/Studenten Aufgaben an die falsche Aufgabe abgeben und vergessen, ihre Arbeit abzugeben. Nur die Schaltfläche „Teilen“ ist in der Möglichkeit für Schüler/Studenten eingeschränkt, ihre Aufgaben abzugeben.

Seit November 2019 bietet die Schaltfläche „Teilen“ die Möglichkeit anzugeben, welchem Kurs ein Schüler/Student einen Anhang hinzufügt. Sie unterstützt jedoch weiterhin nicht die automatische Auswahl einer Aufgabe. Berücksichtigen Sie das Risiko, dass Schüler/Studenten Aufgaben an die falsche Aufgabe abgeben.

Aufgaben überprüfen und benoten

Der letzte Teil des Aufgabenlebenszyklus betrifft die Lehrkraft. Sobald die Schüler/Studenten ihre Aufgabe abgegeben haben, kann die Lehrkraft sie auf die für sie sinnvollste Weise überprüfen. Bei in Drive gespeicherten Dateien kann die Überprüfung direkt im Classroom-Benotungstool erfolgen. Auf Drittanbieteranwendungen kann jedoch nicht im Classroom-Benotungstool zugegriffen werden. Das bedeutet, dass Lehrkräfte beim Überprüfen und Benoten von Aufgaben mehrere Tabs verwenden müssen.

Die Schaltfläche „Teilen“ bietet derzeit keine Lösung für die Benotung und Rückgabe von Aufgaben. Funktionen wie Kommentare zu Abgaben von Schülern/Studenten sind derzeit nicht über die API verfügbar. Sowohl die Benotung als auch die Rückgabe dieser Noten an Schüler/Studenten ist jedoch über die studentSubmissions.patch und studentSubmissions.return möglich. Noten können nur für Kursaufgaben-Stream-Elemente (Aufgaben- und Fragetypen) angegeben werden. Sie sind nur in numerischer Form verfügbar und können entweder als Entwurf oder als Endnote zugewiesen werden.

Um Aufgaben zurückzugeben oder zu benoten, muss die Abgabe des Schülers/Studenten zuerst abgegeben werden. Das ist derzeit ein Unterschied zwischen der Funktionsweise der Classroom-UI und der API.

Zusammenfassung der Unterschiede

In der folgenden Tabelle werden die Schaltfläche „Teilen“ und die CourseWork API für die vier oben genannten Kategorien verglichen: Implementierung, Erstellen und Teilen von Aufgaben, Bearbeiten und Abgeben von Aufgaben sowie Überprüfen und Benoten von Aufgaben.

	Button „Teilen“	CourseWork API
Implementierung	Nur wenige Zeilen JavaScript, daher einfach und schnell zu implementieren	Erfordert das Einrichten von API-Schlüsseln, das Aktivieren von APIs in der Admin-Konsole und eine genauere Überwachung
Aufgaben erstellen und teilen	Leitet Lehrkräfte zum Dialogfeld „Teilen“ der Schaltfläche „Mit Classroom teilen“ weiter Nutzer können alle Stream-Elementtypen außer einem posten Weniger Felder können angegeben werden Ermöglicht das Erstellen von Aufgaben, aber nicht das Abrufen oder Ändern von Aufgabendaten	Kein Dialogfeld für die Schaltfläche „Teilen“ erforderlich Die meisten Felder für Classroom-Aufgaben können angegeben werden Möglichkeit, von Ihrer Anwendung erstellte Kursaufgaben zu ändern Ermöglicht Ihrer App, alle Aufgabendaten aus Classroom abzurufen
Aufgaben bearbeiten und abgeben	Leitet Schüler/Studenten zum Dialogfeld „Teilen“ der Schaltfläche „Mit Classroom teilen“ weiter Ermöglicht Schülern/Studenten, ihre Abgabe an eine beliebige Classroom-Aufgabe anzuhängen Ermöglicht das Anhängen von Abgaben, aber nicht das Abrufen oder Ändern von Abgabedaten Ermöglicht Schülern/Studenten nicht, die Aufgabe abzugeben	Kein Dialogfeld für die Schaltfläche „Teilen“ erforderlich Ermöglicht Schülern/Studenten nur, ihre Abgabe an Aufgaben anzuhängen, die von Ihrer App erstellt wurden Ermöglicht Ihrer App, von Ihrer Anwendung erstellte Abgaben von Schülern/Studenten zu ändern Ermöglicht Schülern/Studenten, ihre Aufgaben abzugeben
Aufgaben überprüfen und benoten	Keine Unterstützung für das Angeben oder Zurückgeben von Noten	Ermöglicht Ihrer App, alle Abgabedaten von Schülern/Studenten im Namen einer Lehrkraft aus Classroom abzurufen Ermöglicht das Zuweisen von Noten für Schüler/Studenten, entweder als Entwurf oder als Endnote Ermöglicht das Ändern von Noten für Schüler/Studenten Ermöglicht das Zurückgeben von Noten an Schüler/Studenten