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.
Es gibt zwei Möglichkeiten, Google Classroom in einen Aufgabenworkflow einzubinden: über die Schaltfläche zum Teilen von Inhalten in Classroom und über 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 Notenrückgabe umfasst.
Hier sehen wir uns die wichtigsten Unterschiede zwischen diesen beiden Entwicklerangeboten an. Wir werden uns die Unterschiede bei der Implementierung und in jeder Phase des Aufgabenlebenszyklus ansehen: Erstellung von Aufgaben, 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 wurde erstellt.
- Die Aufgabe wird mit den Schülern/Studenten geteilt.
- Der Schüler/Student erledigt die Aufgabe.
- Der Schüler reicht die Aufgabe bei der Lehrkraft ein.
- Die Lehrkraft überprü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 der einfachsten Form kann die Integration der Classroom-Schaltfläche „Teilen“ wie im folgenden Snippet 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 Ihre Plattform bereits andere Classroom API-Funktionen wie Klassenlisten nutzt.
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 und 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 ansonsten 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 umfassen alle Arten von Classroom-Beiträgen mit Ausnahme von Quizaufgaben. Unten findest du eine Zusammenfassung aller Beitragstypen und Informationen dazu, ob sie angezeigt werden.
| 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. Über die 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. Über die API hingegen sind alle diese Felder für Lese- und Schreibzugriff verfügbar.
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 CourseWork-Elemente, 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-/Studentenbeiträgen und Noten für diese CourseWork-Elemente 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 können Zuweisungen in Ihrer Anwendung ganz einfach synchronisiert werden, 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 und über die CourseWork API über den Endpunkt studentSubmissions.modifyAttachments möglich. 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 ein Vorteil ist, dass Drittanbieterplattformen verhindern können, dass Schüler und Studenten Aufgaben an der falschen Stelle abgeben oder vergessen, ihre Arbeit einzureichen, 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 jedoch nicht über das Classroom-Bewertungstool 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 von Schülern und Studenten sind derzeit nicht über die API verfügbar. Die Benotung und Rückgabe dieser 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.
| Button „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 überprüfen und benoten | Keine Unterstützung für die Angabe oder Rückgabe von Noten |
|