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 ein anderer als Lehrkraft zugewiesen werden. Die Kennzeichnung „Schüler“ oder „Lehrkraft“ steht für eine Reihe von Berechtigungen für einen bestimmten Nutzer in einem bestimmten Kurs.
- Kursteilnehmer
- Eine Schülerressource stellt einen Nutzer dar, der als Student in einem bestimmten Kurs angemeldet ist. Schüler/Studenten dürfen die Kursdetails und die Lehrkräfte für diesen Kurs sehen.
- Lehrer
- Eine Lehrkraft ist ein Nutzer, der einen bestimmten Kurs unterrichtet. Lehrkräfte können die Kursdetails aufrufen und ändern, Lehrkräfte sowie Schüler und Studenten sowie weitere 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 vom Google Admin SDK zurückgegeben wird.
Der aktuelle Nutzer kann sich mit dem "me"
-Kurzbefehl auch auf seine eigene ID beziehen.
Direkt hinzufügen
Domainadministratoren sind berechtigt, den Einladungsablauf zu umgehen und Nutzer in ihrer Domain direkt zu Kursen in ihrer Domain als Lehrkräfte oder Schüler und Studenten hinzuzufügen. Ein Kurs gilt als innerhalb der Domain des Administrators, wenn sich der Inhaber des Kurses in der Domain des Administrators befindet. Für Nutzer oder Kurse außerhalb der Domain eines authentifizierten Domainadministrators müssen Anwendungen die Zustimmung des Nutzers einholen. Dazu wird eine Einladung mit der Methode invitations.create()
gesendet.
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
$courseId = '123456';
$teacherEmail = 'alice@example.edu';
$teacher = new Google_Service_Classroom_Teacher(array(
'userId' => $teacherEmail
));
try {
$teacher = $service->courses_teachers->create($courseId, $teacher);
printf("User '%s' was added as a teacher to the course with ID '%s'.\n",
$teacher->profile->name->fullName, $courseId);
} catch (Google_Service_Exception $e) {
if ($e->getCode() == 409) {
printf("User '%s' is already a member of this course.\n", $teacherEmail);
} else {
throw $e;
}
}
Python
Wenn Sie weitere 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. Es gilt nicht für ihre Zuweisung zu anderen Kursen oder ihrem Nutzerprofil.
Schüler und Studenten anmelden oder entfernen
Domainadministratoren können Schüler und Studenten innerhalb ihrer Domain mit der students.create()
-Methode direkt hinzufügen, wie im folgenden Beispiel gezeigt:
.NET
Java
PHP
$courseId = '123456';
$enrollmentCode = 'abcdef';
$student = new Google_Service_Classroom_Student(array(
'userId' => 'me'
));
$params = array(
'enrollmentCode' => $enrollmentCode
);
try {
$student = $service->courses_students->create($courseId, $student, $params);
printf("User '%s' was enrolled as a student in the course with ID '%s'.\n",
$student->profile->name->fullName, $courseId);
} catch (Google_Service_Exception $e) {
if ($e->getCode() == 409) {
print "You are already a member of this course.\n";
} else {
throw $e;
}
}
Python
Wenn Sie Schüler im Auftrag 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 Schüler oder Student aus dem Kurs entfernt. Die Anmeldung in anderen Kursen oder in seinem Nutzerprofil wirkt sich nicht darauf aus.
Kurse eines Nutzers abrufen
Mit dem courses.list()
kannst du eine Liste der Kurse eines Schülers/Studenten oder Lehrkräftes abrufen. Füge die entsprechenden Nutzer studentId
oder teacherId
hinzu.
Profil eines Nutzers abrufen
Um das gekürzte Profil, einschließlich ID und Name, für einen Nutzer abzurufen, rufen Sie userProfiles.get()
mit der Nutzer-ID, E-Mail-Adresse oder dem Nutzer für den anfragenden Nutzer auf.
Zum Abrufen des Feldes emailAddress
müssen Sie den Bereich classroom.profile.emails
angeben.
Die zurückgegebene ID entspricht der Directory API-Nutzerressource, die die entsprechende studentId
oder teacherId
enthält.