Fügt einen Nutzer als Schüler/Student zu einem Kurs hinzu.
Domainadministratoren können Nutzer innerhalb ihrer Domain direkt als Schüler und Studenten zu Kursen innerhalb ihrer Domain hinzufügen. Schüler und Studenten können sich mithilfe eines Einschreibungscodes selbst zu einem Kurs hinzufügen.
Diese Methode gibt die folgenden Fehlercodes zurück:
PERMISSION_DENIED
, wenn der anfragende Nutzer nicht berechtigt ist, in diesem Kurs Schüler/Studenten zu erstellen, oder wenn Zugriffsfehler aufgetreten sind.NOT_FOUND
, wenn die angeforderte Kurs-ID nicht vorhanden ist.FAILED_PRECONDITION
, wenn das Konto des angeforderten Nutzers deaktiviert ist, bei den folgenden Anfragefehlern:- CourseMemberLimitReached
- CourseNotModifiable
- UserGroupsMembershipLimitReached
- InactiveCourseOwner
ALREADY_EXISTS
, wenn der Nutzer bereits Schüler/Student oder Lehrkraft des Kurses ist.
HTTP-Anfrage
POST https://classroom.googleapis.com/v1/courses/{courseId}/students
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
courseId |
ID des Kurses, in dem der Teilnehmer erstellt werden soll. Diese Kennung kann entweder die von Classroom zugewiesene ID oder eine |
Abfrageparameter
Parameter | |
---|---|
enrollmentCode |
Einschreibungscode des Kurses, in dem der Schüler/Student erstellt werden soll. Dieser Code ist erforderlich, wenn |
Anfragetext
Der Anfragetext enthält eine Instanz von Student
.
Antworttext
Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von Student
.
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/classroom.rosters
https://www.googleapis.com/auth/classroom.profile.emails
https://www.googleapis.com/auth/classroom.profile.photos
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.