Einführung

Aufgaben werden in Classroom als Kursaufgaben bezeichnet und befinden sich auf der Seite "Kursaufgaben" des jeweiligen Classroom-Kurses. Es gibt vier Arten von Kursaufgaben, aber nur der Typ „Aufgabe“. Wie Sie die anderen Arten von Kursaufgaben verwalten, erfahren Sie im Leitfaden zur Verwaltung von Kursaufgaben.

Google Classroom bietet zwei Möglichkeiten zur Einbindung in einen Aufgabenworkflow: die Schaltfläche zum Freigeben von Classroom und die Classroom API. Mit der Schaltfläche zum Freigeben können Nutzer Inhalte als beliebiges Streamelement über ein Classroom-Pop-up-Dialogfeld teilen. Die Classroom API hingegen ermöglicht einen Anfang-zu-Ende-Workflow für Aufgaben, der das Erstellen von Aufgaben, das Erstellen und Verwalten von abgegebenen Aufgaben sowie die Notenrückgabe umfasst.

An dieser Stelle sehen wir uns die wichtigsten Unterschiede zwischen diesen beiden Angeboten für Entwickler an. Genauer gesagt werden wir uns die Unterschiede bei der Implementierung und die einzelnen Phasen des Lebenszyklus von Aufgaben ansehen: Aufgabenerstellung, Einreichungen von Schülern und Studenten sowie Benotung/Feedback.

Den Lebenszyklus einer Zuweisung verstehen

Bevor wir auf die Unterschiede zwischen der Schaltfläche „Teilen“ und der CourseWork API eingehen, definieren wir zuerst den Lebenszyklus einer Aufgabe im Kontext von Classroom. So können Sie besser verstehen, wie Lehrkräfte und Lernende mit Aufgaben in Classroom interagieren.

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

1. Die Aufgabe wurde erstellt.
2. Die Aufgabe wird mit den Schülern/Studenten geteilt.
3. Der Schüler/Student schließt die Aufgabe ab.
4. Der Schüler/Student gibt die Aufgabe an die Lehrkraft ab.
5. Die Lehrkraft prüft und benotet Aufgaben.

Dank der Integration in Classroom-Aufgaben können Kursleiter und -teilnehmer nahtlos zwischen Classroom und Drittanbieter-Anwendungen wechseln. Anstatt die Details einer Aufgabe oder abgegebenen Aufgaben zu verwalten, können sich Nutzer auf Ihre Anwendung verlassen.

Implementierung

Der erste Unterschied zwischen der Schaltfläche „Teilen“ und der CourseWork API ist die Implementierung. Für Entwickler ist die Schaltfläche „Teilen“ eine einfachere Methode, um Inhalte in Classroom zu teilen, da nur die erforderliche JavaScript-Ressource und ein Tag für die Schaltfläche „Teilen“ hinzugefügt werden müssen. In der einfachsten Form sieht die Integration der Schaltfläche zum Teilen in Classroom wie folgt aus:

<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 Einbindung der Schaltfläche „Teilen“ findest du hier.

Die CourseWork API hingegen ist Teil der Google Classroom API REST API, für die API-Schlüssel mit der Google Cloud Console eingerichtet und aktiviert sowie Best Practices für die API-Integration befolgt werden müssen. Dies ist weniger bedenklich, wenn auf Ihrer Plattform bereits andere Classroom API-Funktionen wie Rostering genutzt werden.

Aufgaben erstellen und freigeben

Die Schaltfläche „Freigeben“ und die CourseWork API ermöglichen die ersten beiden Schritte des Aufgabenworkflows, also das Erstellen und Teilen der Aufgabe mit den Schülern oder Studenten. Es gibt jedoch einige entscheidende Unterschiede, die Sie beachten sollten, bevor Sie eine Lösung auswählen.

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

Bei beiden Optionen sind alle Arten von Classroom-Beiträgen verfügbar, mit Ausnahme von Quizaufgaben. Eine Zusammenfassung aller Beitragstypen und ob sie angezeigt werden, findest du unten.

Beitragstyp	Schaltfläche „Teilen“	CourseWork-API
Assignment	X	X
Aufgabe mit Quiz
Question: Kurzantwort	X	X
Question: Multiple-Choice-Frage	X	X
Material	X	X
Ankündigung	X	X

Funktionen wie das Angeben des Titels und der Beschreibung können von Ihrer Anwendung für beide Lösungen programmatisch angegeben werden. Durch die Einbindung der Schaltfläche „Teilen“ können Nutzer Felder wie Fälligkeitsdatum, Thema, individueller Modus und Anzahl der Punkte im Pop-up-Dialogfeld festlegen. Diese können jedoch nicht programmatisch von einer Drittanbieter-App festgelegt werden. Die API hingegen stellt alle diese Felder sowohl für den Lese- als auch für den Schreibzugriff bereit.

Über die Schaltfläche „Teilen“ können in der Anwendung außerdem keine Felder für Fragetypen angegeben werden, z.B. Multiple-Choice-Optionen.

Zuweisungen ändern

Einer der Vorteile der Einbindung in die Classroom API ist es, dass die Nutzer sich ändernde Aufgabendetails nicht mehr manuell synchronisieren müssen. Die Schaltfläche „Teilen“ bietet keine Möglichkeit, Aufgaben programmatisch zu aktualisieren oder zu löschen. Alle erforderlichen Änderungen müssen daher vom Nutzer über die Classroom-Benutzeroberfläche vorgenommen werden.

Mit der CourseWork API können Sie sowohl Aufgaben ändern und löschen, die von Ihrer Anwendung erstellt wurden, als auch Details zu Aufgaben abrufen, die in den Kursen des Nutzers gepostet wurden. Es ist jedoch zu beachten, dass CourseWork-Elemente, die nicht von derselben Entwicklerkonsole erstellt wurden, über diese Entwicklerkonsole nicht geändert werden können. Dieses Berechtigungsmodell gilt für den Rest des Aufgabenlebenszyklus, z. B. für das Verwalten von abgegebenen Aufgaben und Noten von Schülern oder Studenten. Für diese Kursaufgabenelemente kann nicht darauf zugegriffen werden.

Aufgaben automatisch synchronisieren

Mit Pub/Sub-Push-Benachrichtigungen kann Ihre Anwendung Benachrichtigungen abonnieren, die ein Ereignis auslösen, wenn sich Änderungen an Kurswork-Elementen und den zugehörigen abgegebenen Aufgaben von Schülern oder Studenten ändern. Auf diese Weise kann Ihre Anwendung Aufgaben einfach synchronisieren, da nicht ständig geprüft werden muss, ob Inhalte in Classroom aktualisiert wurden.

Aufgaben erledigen und abgeben

Jede Aufgabe ist mit N Einreichungen von Schülern/Studenten verknüpft, wobei N die Anzahl der Schüler/Studenten ist, denen die Aufgabe zugewiesen wurde. Mit anderen Worten: Zu jeder Aufgabe ist jedem Schüler/Studenten eine Aufgabe zugeordnet, auf die er mit einer eindeutigen ID zugreifen kann. Diese Aufgaben von Schülern/Studenten werden automatisch erstellt und können von Ihrer Anwendung mit den GET- und LIST-Endpunkten von Schülern/Studenten abgerufen werden.

Sowohl über die Schaltfläche „Freigeben“ als auch über die Kurswork API können Links oder Dateien zu Aufgaben von Schülern/Studenten hinzugefügt werden. Mit der Schaltfläche „Freigeben“ erfolgt dies über einen ähnlichen Workflow wie über das Dialogfeld zum Erstellen von Aufgaben durch Lehrkräfte und die CourseWork API über den Endpunkt studentSubmissions.modifyAttachments. Aufgrund der zuvor beschriebenen Einschränkungen für API-Berechtigungen ist diese Funktionalität jedoch auf die von Ihrer Anwendung erstellten Kurswork-Elemente beschränkt. Diese Einschränkung gilt nicht für die Schaltfläche „Teilen“. Schüler und Studenten können ihre Arbeit jeder Aufgabe hinzufügen, die sie in Classroom auswählen.

Workflow für Schüler/Studenten beenden

Die Einschränkung der Kursfunktion ist zwar kein Anwendungsfall für Plattformen, die das Erstellen von Aufgaben nicht unterstützen. Ein Vorteil besteht jedoch darin, dass Drittanbieter-Plattformen verhindern können, dass Schüler und Studenten eine falsche Aufgabe einreichen und vergessen, ihre Aufgabe abzugeben. Nur die Schaltfläche zum Freigeben hat nur die Möglichkeit, dass die Schüler ihre Aufgaben abgeben können.

Seit November 2019 können Sie über die Schaltfläche „Freigeben“ angeben, welchem Kurs ein Schüler oder Student einen Anhang hinzufügt. Die automatische Auswahl von Aufgaben wird jedoch nicht unterstützt. Beachten Sie das Risiko, dass Schüler und Studenten die falsche Aufgabe einreichen.

Aufgaben prüfen und benoten

Der letzte Teil des Lebenszyklus einer Aufgabe geht auf die Lehrkraft zurück. Nachdem die Schüler ihre Aufgabe erfolgreich abgegeben haben, kann die Lehrkraft sie so bewerten, wie es am sinnvollsten ist. In Google Drive gespeicherte Dateien können sie direkt in der Classroom-Benotung prüfen. Auf Anwendungen von Drittanbietern kann jedoch nicht über die Classroom-Benotung zugegriffen werden. Dies hat zur Folge, dass Lehrkräfte beim Prüfen und Benoten von Aufgaben auf mehreren Tabs navigieren müssen.

Die Schaltfläche „Freigeben“ bietet derzeit keine Möglichkeit, Aufgaben zu benoten und zurückzugeben. Funktionen wie Kommentare zu abgegebenen Aufgaben von Schülern oder Studenten werden derzeit nicht über die API zur Verfügung gestellt. Über die Endpunkte studentSubmissions.patch und studentSubmissions.return können Sie die Noten aber auch benoten und zurückgeben. Noten können nur für Kurswork-Stream-Elemente (Aufgaben- und Fragetypen) angegeben werden. Sie sind nur in numerischer Form verfügbar und können als Entwurf oder als Abschlussnote zugewiesen werden.

Um Aufgaben zurückzugeben oder zu benoten, muss die abgegebene Aufgabe des Schülers/Studenten zuerst abgegeben werden. Dies ist derzeit eine Diskrepanz zwischen der Funktionsweise der Classroom-Benutzeroberfläche und der API.

Zusammenfassung der Unterschiede

Die folgende Tabelle fasst die in den vorherigen Abschnitten behandelten Punkte zusammen. Sie zeigt einen direkten Vergleich der Schaltfläche „Freigeben“ und der CourseWork API für die vier oben genannten Kategorien: Implementierung, Erstellen und Freigeben von Aufgaben, Erledigen und Einreichen von Aufgaben sowie Überprüfen und Benoten von Aufgaben.

	Schaltfläche „Teilen“	CourseWork-API
Implementierung	Nur wenige Zeilen JavaScript, was die Implementierung einfach und schnell macht	Erfordert das Einrichten von API-Schlüsseln, das Aktivieren von APIs in der Admin-Konsole und ein genaueres Monitoring
Zuweisungen erstellen und freigeben	Leitet Lehrkräfte zum Dialogfeld zum Teilen der Schaltfläche „Teilen“ in Classroom weiter Nutzer können alle bis auf einen Stream-Elementtyp posten Es können weniger Felder angegeben werden 1 ermöglicht das Erstellen von Aufgaben, keine Möglichkeit, Aufgabendaten abzurufen oder zu ändern.	Kein Dialogfeld für die Schaltfläche „Teilen“ erforderlich Die meisten Felder für Classroom-Aufgaben können angegeben werden Von Ihrer Anwendung erstellte Kursaufgaben ändern Ermöglicht Ihrer App, alle Aufgabendaten aus Classroom abzurufen
Aufgaben abschließen und abgeben	Leitet Schüler/Studenten zum Dialogfeld zum Teilen der Schaltfläche „Teilen“ in Classroom weiter Schüler/Studenten können ihre abgegebenen Aufgaben an jede Classroom-Aufgabe anhängen. 1 ermöglicht das Anhängen der abgegebenen Aufgabe; es ist nicht möglich, abgegebene Aufgaben abzurufen oder zu ändern. Schüler/Studenten können die Aufgabe nicht abgeben	Kein Dialogfeld für die Schaltfläche „Teilen“ erforderlich Schüler und Studenten können ihre abgegebenen Aufgaben nur an Aufgaben anhängen, die von Ihrer App erstellt wurden. Ermöglicht deiner App, von der App erstellte Aufgaben von Schülern/Studenten zu ändern Schülern und Studenten die Möglichkeit gibt, ihre Aufgaben abzugeben
Aufgaben prüfen und benoten	Keine Unterstützung für das Angeben oder Zurückgeben von Noten	Ermöglicht Ihrer App, im Namen einer Lehrkraft alle abgegebenen Daten von Schülern oder Studenten aus Classroom abzurufen Sie bietet die Möglichkeit, Schülern oder Studenten Noten als Entwurf oder als endgültige Aufgabe zuzuweisen. Bietet die Möglichkeit, Noten von Schülern/Studenten zu ändern Sie kann Schülern/Studenten die Möglichkeit geben, Noten bekannt zu geben.