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 im Leitfaden zum Verwalten von Kursaufgaben.
Für die Integration in einen Aufgabenworkflow gibt es in Google Classroom zwei Möglichkeiten: die Schaltfläche zum Teilen von Inhalten in Classroom und die Classroom API. Mit der Schaltfläche „Teilen“ können Nutzer Inhalte als beliebige Stream-Elemente über ein Classroom-Pop-up-Dialogfeld teilen. Die Classroom API ermöglicht dagegen einen vollständigen Aufgabenworkflow, der das Erstellen von Aufgaben, das Erstellen und Verwalten von Schülerbeiträgen sowie die Rückgabe von Noten umfasst.
Hier sehen Sie die wichtigsten Unterschiede zwischen diesen beiden Entwicklerangeboten. Wir werden uns die Unterschiede in der Implementierung und in jeder Phase des Aufgabenlebenszyklus ansehen: Aufgabenerstellung, Einreichungen von Schülern/Studenten und Benotung/Feedback.
Den Lebenszyklus von Aufgaben verstehen
Bevor wir uns mit den Unterschieden zwischen der Schaltfläche „Teilen“ und der CourseWork API befassen, definieren wir zunächst, was wir im Kontext von Classroom als Lebenszyklus einer Aufgabe betrachten. So können Sie nachvollziehen, wie Lehrkräfte und Schüler/Studenten mit Aufgaben in Classroom interagieren.
Bei der Integration in Classroom-Aufgaben sind fünf Hauptschritte zu beachten:
- Die Aufgabe wird erstellt.
- Die Aufgabe wird mit den Schülern/Studenten geteilt.
- Der Schüler/Student erledigt die Aufgabe.
- Der Schüler/Student gibt die Aufgabe bei der Lehrkraft ab.
- Die Lehrkraft prüft und benotet die Aufgaben.
Durch die Integration in Classroom-Aufgaben können Lehrkräfte und Lernende nahtlos zwischen Classroom und Drittanbieteranwendungen wechseln. Anstatt die Details einer Aufgabe oder die Einsendungen von Schülern/Studenten zu verwalten, können Nutzer sich 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 und ein Tag für die Schaltfläche „Teilen“ hinzugefügt werden müssen. In seiner einfachsten Form kann die Einbindung der Classroom-Schaltfläche zum 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>
Die CourseWork API ist hingegen Teil der Google Classroom API REST API, für die API-Schlüssel mit der Google Cloud Console eingerichtet und aktiviert werden müssen. Außerdem müssen Best Practices für die Integration in eine API eingehalten werden. Das ist weniger problematisch, wenn auf Ihrer Plattform bereits andere Classroom API-Funktionen wie Klassenlisten verwendet werden.
Aufgaben erstellen und teilen
Sowohl die Schaltfläche „Teilen“ als auch die CourseWork API ermöglichen die ersten beiden Schritte des Aufgabenworkflows: das 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.
Im Grunde ermöglichen beide Lösungen, Links oder Dateien als Aufgaben in Classroom zu posten. Dies 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 die Möglichkeit, Inhalte als Aufgabe zu posten. Sie sollten jedoch überlegen, ob Ihre Anwendung die Flexibilität benötigt, diese Inhalte als andere Kursarbeitstypen oder sogar als Ankündigung zu posten.
Beide Angebote enthalten alle Classroom-Beitragstypen mit Ausnahme von Quizaufgaben. Unten findest du eine Zusammenfassung aller Beitragstypen und Informationen dazu, ob sie öffentlich sichtbar sind.
| Beitragstyp | Teilen-Schaltfläche | CourseWork API |
|---|---|---|
| Assignment | X | X |
| Aufgabe mit Quiz | ||
| Frage: Kurzantwort | X | X |
| Frage: Multiple Choice | 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. Mit der Integration der Schaltfläche „Teilen“ können Nutzer Felder wie Fälligkeitsdatum, Thema, individueller Modus und Anzahl der Punkte im Pop-up-Dialogfeld festlegen. Diese Felder können jedoch nicht programmatisch von einer Drittanbieter-App festgelegt werden. Die API hingegen bietet Lese- und Schreibzugriff auf alle diese Felder.
Zuweisungen ändern
Einer der Vorteile der Integration in die Classroom API ist, dass Nutzer die sich ändernden Details ihrer Aufgaben nicht mehr manuell synchronisieren müssen. Die Schaltfläche „Teilen“ bietet keine Funktionen zum programmatischen Aktualisieren oder Löschen von Aufgaben. Alle erforderlichen Änderungen müssen daher vom Nutzer über die Classroom-Benutzeroberfläche vorgenommen werden.
Mit der CourseWork API können Sie von Ihrer Anwendung erstellte Aufgaben ändern und löschen sowie Details zu allen Aufgaben abrufen, die in den Kursen des Nutzers veröffentlicht wurden. Es ist jedoch wichtig zu beachten, dass Kursmaterialien, die nicht über dieselbe Entwicklerkonsole erstellt wurden, auch nicht über diese Entwicklerkonsole geändert werden können. Dieses Berechtigungsmodell erstreckt sich auf den gesamten Lebenszyklus der Aufgabe. So kann beispielsweise nicht auf die Verwaltung von Schüler-/Studenteneinsendungen und Noten 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 Änderungen an Kursaufgaben und den zugehörigen Schülerarbeiten ergeben. So kann Ihre Anwendung Aufgaben ganz einfach synchronisieren, da nicht ständig geprüft werden muss, ob Inhalte in Classroom aktualisiert wurden.
Aufgaben erledigen und einreichen
Jede Aufgabe ist mit N Schüler- oder Studenteneinreichungen verknüpft, wobei N die Anzahl der Schüler oder Studenten ist, denen die Aufgabe zugewiesen wurde. Das bedeutet, dass für jede Aufgabe für jeden Schüler/Studenten eine zugehörige Einsendung vorhanden ist, auf die mit einer eindeutigen ID zugegriffen werden kann. Diese Schülerarbeiten werden automatisch erstellt und können von Ihrer Anwendung mit den GET- und LIST-Endpunkten für Schülerarbeiten abgerufen werden.
Sowohl die Schaltfläche „Teilen“ als auch die CourseWork API unterstützen das Hinzufügen von Links oder Dateien zur Einreichung eines Schülers oder Studenten für eine Aufgabe. Über die Schaltfläche „Teilen“ ist dies über einen ähnlichen Workflow wie im Dialogfeld zum Erstellen von Aufgaben für Lehrkräfte möglich. Die CourseWork API bietet hierfür den Endpunkt studentSubmissions.modifyAttachments. Aufgrund der oben beschriebenen Einschränkungen für API-Berechtigungen ist diese Funktion jedoch auf CourseWork-Elemente beschränkt, die von Ihrer Anwendung erstellt wurden. 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.
Studenten-Workflow beenden
Die Einschränkung der Berechtigung „CourseWork“ ist zwar nicht für Plattformen gedacht, die das Erstellen von Aufgaben nicht unterstützen, aber sie bietet den Vorteil, dass Drittanbieterplattformen verhindern können, dass Schüler und Studenten Aufgaben an der falschen Stelle abgeben oder vergessen, ihre Arbeit abzugeben, da nur die Schaltfläche „Teilen“ eingeschränkt ist.
Aufgaben prüfen und benoten
Der letzte Teil des Aufgabenlebenszyklus liegt wieder bei der Lehrkraft. Nachdem die Schüler ihre Aufgabe erfolgreich abgegeben haben, kann die Lehrkraft sie auf die für sie sinnvollste Weise überprüfen. Bei Dateien, die in Drive gespeichert sind, können sie direkt im Classroom-Benotungstool überprüft werden. Auf Drittanbieteranwendungen kann im Classroom-Bewertungstool jedoch nicht zugegriffen werden. Das bedeutet, dass Lehrkräfte beim Überprüfen und Bewerten von Aufgaben mehrere Tabs öffnen müssen.
Die Schaltfläche „Teilen“ bietet derzeit keine Lösung für die Bewertung und Rückgabe von Aufgaben. Funktionen wie Kommentare zu abgegebenen Aufgaben sind derzeit nicht über die API verfügbar. Die Bewertung und Rückgabe von Noten an Schüler und Studenten ist jedoch über die Endpunkte studentSubmissions.patch und studentSubmissions.return möglich. Noten können nur für CourseWork-Streamelemente (Aufgaben- und Fragetypen) angegeben werden. Sie sind nur in numerischer Form verfügbar und können entweder als vorläufige oder endgültige Note zugewiesen werden.
Zusammenfassung der Unterschiede
Die folgende Tabelle fasst alles zusammen, was in den vorherigen Abschnitten behandelt wurde. Sie enthält einen direkten Vergleich der Schaltfläche „Teilen“ und der CourseWork API für die vier oben besprochenen Kategorien: Implementierung, Erstellen und Teilen von Aufgaben, Bearbeiten und Einreichen von Aufgaben sowie Überprüfen und Bewerten von Aufgaben.
| Schaltfläche „Teilen“ | CourseWork API | |
|---|---|---|
| Implementierung | Nur wenige Zeilen JavaScript-Code, sodass die Implementierung einfach und schnell ist | Erfordert das Einrichten von API-Schlüsseln, das Aktivieren von APIs in der Admin-Konsole und eine genauere Überwachung |
| Aufgaben erstellen und teilen |
|
|
| Aufgaben erledigen und einreichen |
|
|
| Aufgaben prüfen und benoten | Keine Unterstützung für die Angabe oder Rückgabe von Noten |
|