Lernende 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 als 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.
- Studenten
- Eine Ressource vom Typ „Schüler/Student“ steht für einen Nutzer, der in einem bestimmten Kurs angemeldet ist. Schüler und Studenten können die Kursdetails und die Lehrkräfte für diesen Kurs sehen.
- Lehrkräfte
- Eine Lehrkraftressource stellt einen Nutzer dar, der einen bestimmten Kurs unterrichtet. Lehrkräfte können die Kursdetails aufrufen und ändern, Lehrkräfte und Schüler/Studenten einsehen und zusätzliche Lehrkräfte und Schüler/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 mit der Abkürzung "me"
auf seine eigene ID verweisen.
Direktes Hinzufügen
Domainadministratoren können den Einladungsvorgang umgehen und Nutzer innerhalb ihrer Domain direkt als Lehrkräfte oder Schüler oder Studenten zu Kursen in ihrer Domain hinzufügen. Ein Kurs gilt als innerhalb der Domain des Administrators, wenn der Inhaber des Kurses in der Domain des Administrators ist. Bei Nutzern oder Kursen 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 mit teachers.create()
Lehrkräfte aus ihrer Domain direkt Kursen hinzufügen, wie im folgenden Beispiel gezeigt:
.NET
Java
PHP
Python
Wenn Sie zusätzliche Lehrkräfte im Namen einer authentifizierten 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 das Nutzerprofil ist davon nicht betroffen.
Schüler/Studenten registrieren oder entfernen
Domainadministratoren können Schüler und Studenten mit der Methode students.create()
direkt in ihrer Domain hinzufügen, wie im folgenden Beispiel gezeigt:
.NET
Java
PHP
Python
Wenn Sie Schüler/Studenten im Namen einer authentifizierten Lehrkraft hinzufügen, müssen Sie die Methode invitations.create()
verwenden.
Mit der Methode students.delete()
können Sie Teilnehmer aus einem Kurs entfernen. Dadurch wird nur der angegebene Teilnehmer aus dem Kurs entfernt. Dies hat keine Auswirkungen auf seine Anmeldung in anderen Kursen oder auf sein Nutzerprofil.
Kurse eines Nutzers abrufen
Wenn Sie eine Liste der Kurse für einen Schüler oder eine Lehrkraft abrufen möchten, rufen Sie courses.list()
auf und geben die studentId
oder teacherId
des entsprechenden Nutzers an.
Nutzerprofil abrufen
Wenn Sie das gekürzte Profil, einschließlich ID und Name, für einen Nutzer abrufen möchten, rufen Sie userProfiles.get()
mit der ID, E-Mail-Adresse oder „me“ des anfragenden Nutzers auf.
Zum Abrufen des Felds emailAddress
müssen Sie den Bereich classroom.profile.emails
angeben.
Die zurückgegebene ID entspricht der Nutzerressource der Directory API mit dem übereinstimmenden studentId
oder teacherId
.
Kursinhaber verwalten
Domainadministratoren können die Inhaberschaft von Kursen zwischen Lehrkräften übertragen. Wichtige Informationen finden Sie im Abschnitt Eigentümerschaft des Kurses übertragen.