Schüler, Studenten und Lehrkräfte sind spezifische Zuordnungen zwischen einem Nutzerprofil und einem Kurs, die die Rolle dieses Nutzers im Kurs darstellen. Die Bezeichnungen „Schüler/Student“ und „Lehrkraft“ sind nicht global: Ein Nutzer kann für einen Kurs als Lehrkraft und für einen anderen Schüler/Student zugewiesen werden. Die Bezeichnung „Schüler/Student“ oder „Lehrkraft“ steht für eine Reihe von Berechtigungen für einen bestimmten Nutzer in einem bestimmten Kurs.
- Kursteilnehmer
- Eine Teilnehmerressource stellt einen Nutzer dar, der als Student in einem bestimmten Kurs angemeldet ist. Schüler oder Studenten können sich die Kursdetails und die Lehrkräfte für den Kurs ansehen.
- Lehrer
- Eine Ressource für Lehrkräfte ist ein Nutzer, der einen bestimmten Kurs unterrichtet. Lehrkräfte können die Kursdetails abrufen und ändern, Lehrkräfte und Schüler/Studenten ansehen und zusätzliche Lehrkräfte und Schüler oder Studenten verwalten.
Schüler/Studenten und Lehrkräfte werden anhand der eindeutigen ID oder E-Mail-Adresse des Nutzers identifiziert, die von der Directory API zurückgegeben wird.
Der aktuelle Nutzer kann auch mithilfe von "me"
auf seine eigene ID verweisen.
Direktes Hinzufügen
Domainadministratoren sind berechtigt, den Einladungsprozess zu umgehen und Nutzer innerhalb ihrer Domain direkt als Lehrkräfte, Schüler oder Studenten zu Kursen in ihrer Domain hinzuzufügen. Kurse werden in der Domain des Administrators angesehen, wenn der Inhaber des Kurses zur Domain des Administrators gehört. Für Nutzer oder Kurse außerhalb der Domain eines authentifizierten Domainadministrators müssen Anwendungen die Einwilligung des Nutzers einholen, indem sie eine Einladung mit der Methode invitations.create()
senden.
Lehrkräfte hinzufügen oder entfernen
Domainadministratoren können Lehrkräfte innerhalb ihrer Domain direkt mit teachers.create()
zu Kursen hinzufügen, wie im folgenden Beispiel gezeigt:
.NET
Java
PHP
Python
Wenn Sie weitere Lehrkräfte für eine authentifizierte Lehrkraft hinzufügen, müssen Sie die Methode invitations.create()
verwenden.
Mit der Methode teachers.delete()
können Sie zusätzliche Lehrkräfte aus einem Kurs entfernen. Dadurch wird nur die angegebene Lehrkraft aus dem Kurs entfernt. Die Zuweisung zu anderen Kursen oder zu ihrem Nutzerprofil ist davon nicht betroffen.
Schüler/Studenten anmelden oder entfernen
Domainadministratoren können mit der Methode students.create()
Schüler oder Studenten direkt in ihrer Domain hinzufügen, wie im folgenden Beispiel gezeigt:
.NET
Java
PHP
Python
Wenn Sie Schüler oder Studenten im Namen einer authentifizierten Lehrkraft hinzufügen, müssen Sie die Methode invitations.create()
verwenden.
Mit der Methode students.delete()
können Sie einen Schüler oder Studenten aus einem Kurs entfernen. Dadurch wird nur der angegebene Teilnehmer aus dem Kurs entfernt. Die Anmeldung in anderen Kursen oder in seinem Nutzerprofil ist davon nicht betroffen.
Kurse eines Nutzers abrufen
Um eine Liste der Kurse eines Schülers oder Studenten oder einer Lehrkraft abzurufen, rufen Sie courses.list()
auf und geben Sie die studentId
oder teacherId
des entsprechenden Nutzers an.
Nutzerprofil abrufen
Um das gekürzte Profil einschließlich ID und Name für einen Nutzer abzurufen, rufen Sie userProfiles.get()
mit der ID, der E-Mail-Adresse oder dem „me“ des Nutzers für den anfragenden Nutzer auf.
Zum Abrufen des Felds emailAddress
müssen Sie den Bereich classroom.profile.emails
einbeziehen.
Die zurückgegebene ID entspricht der Ressource „Directory API-Nutzer“, die die entsprechende studentId
oder teacherId
enthält.
Kursinhaber verwalten
Domainadministratoren können die Eigentümerschaft von Kursen auf Lehrkräfte übertragen. Weitere wichtige Informationen finden Sie im Abschnitt Eigentümerschaft des Kurses übertragen.