Auf dieser Seite finden Sie einige häufige Missverständnisse und Grenzfälle, die Sie beim Entwerfen und Implementieren Ihres Classroom-Add-ons berücksichtigen sollten. Wir empfehlen Ihnen, Failsafes und Tests zu implementieren, die diese Fälle abdecken.
Google Classroom-Konzepte
In diesem Abschnitt werden Grenzfälle und Konzepte für Add-ons beschrieben, die für die gesamte Google Classroom-Plattform gelten.
Kurse und Nutzerrollen
Ein Kurs ist die zentrale Organisationseinheit, die Lehrkräfte mit Lernenden verbindet. Kurse sind die oberste Organisationsebene in der Google Classroom API.
Einzelne Nutzer können einem Kurs als „Lehrkräfte“ oder „Schüler/Studenten“ hinzugefügt werden. Die Rolle eines Nutzers im Kurs ist nicht an seine Rolle in der Bildungseinrichtung gebunden. Das bedeutet, dass ein Schüler/Student der Bildungseinrichtung kann als Lehrkraft in einem Kurs tätig sein und Lehrkräfte als Schüler/Studenten an Kursen teilnehmen können. In den meisten Fällen steht ein Kurs für ein regelmäßig angebotenes akademisches Fach. Kurse werden aber auch erstellt, um Studentenclubs zu organisieren oder eine berufliche Weiterbildung durchzuführen.
Die folgenden Informationen gelten für alle Kurse in Google Classroom.
Lehrkräfte von Kursen:
- Ein Kurs kann mehrere Lehrkräfte haben.
- Lehrkräfte können einem Kurs jederzeit hinzugefügt werden.
- Lehrkräfte können jederzeit aus einem Kurs entfernt werden.
Streamelement
Streamelemente sind die geposteten Inhalte, die für Mitglieder eines Kurses freigegeben wurden. Entwickler und Lehrkräfte können Add-on-Anhänge für drei Arten von Streamelementen erstellen: Ankündigungen, Aufgaben und Materialien.
Lehrkräfte erstellen Ankündigungen oben auf der Seite „Stream“ in der Classroom-Benutzeroberfläche. Lehrkräfte erstellen Aufgaben und Materialien, indem sie auf dem Tab „Aufgaben“ auf die Schaltfläche Erstellen klicken. Entwickler können diese programmatisch über die Classroom API erstellen.
Eine Aufgabe ist ein Streamelement, über das Schüler/Studenten eine Aufgabe einreichen können. Aufgaben sind die einzige Art von Streamelement, die in der Notenübersicht angezeigt wird und ein Add-on-Anhang enthalten kann.
Streamelemente:
- Eine Aufgabe oder ein Material kann einer Teilmenge der Schüler/Studenten im Kurs zugewiesen werden.
- Eine Aufgabe kann benotet oder unbenotet sein. Lehrkräfte können den Benotungsstatus einer Aufgabe jederzeit ändern.
- Eine Aufgabe kann mehrere Anhänge haben.
- Eine Aufgabe kann Anhänge verschiedener Typen haben. Eine Aufgabe kann beispielsweise gleichzeitig Google Docs-Dokumente, YouTube-Videos und Add-on-Anhänge enthalten.
- Eine Aufgabe kann Add-on-Anhänge von mehreren Entwicklern haben.
- Entwickler können Informationen zu jedem Streamelement mit einem ihrer Add-on-Anhänge abrufen und ändern.
- Entwickler können die Abgabe eines Schülers oder Studenten für eine Aufgabe, die eines ihrer Add-ons enthält, einreichen, zurückziehen oder zurückgeben.
- Entwickler können Noten nur für einzelne Einreichungen von Schülern/Studenten in von ihnen erstellten Aufgaben festlegen.
Gekopierte Streamelemente
Lehrkräfte können ein Streamelement kopieren, indem sie einen Kurs kopieren, eine Aufgabe wiederverwenden oder ein Streamelement in mehreren Kursen veröffentlichen. In unserem Leitfaden zu kopierten Inhalten erfahren Sie, wie das Add-on mit diesen Szenarien umgehen kann.
Institution des Nutzers
Die Google Classroom API gibt keine IDs für die Bildungseinrichtung, das Gebäude oder eine andere Mitgliedschaft eines Nutzers über die Kursebene hinaus zurück.