Method: courses.students.create

Fügen Sie einen Nutzer als Schüler/Studenten eines Kurses hinzu.

Domainadministratoren können Nutzer in ihrer Domain direkt als Schüler oder Studenten zu Kursen in ihrer Domain hinzufügen. Schüler/Studenten können sich mit einem Anmeldecode selbst für einen Kurs anmelden.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn der anfragende Nutzer keine Schüler oder Studenten in diesem Kurs erstellen darf, oder aufgrund von Zugriffsfehlern.
  • 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 im Kurs ist.

HTTP-Anfrage

POST https://classroom.googleapis.com/v1/courses/{courseId}/students

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
courseId

string

Kennzeichnung des Kurses, in dem der Schüler/Student erstellt werden soll. Diese Kennung kann entweder die in Classroom zugewiesene Kennung oder eine alias sein.

Abfrageparameter

Parameter
enrollmentCode

string

Der Registrierungscode des Kurses, in dem der Schüler/Student erstellt werden soll. Dieser Code ist erforderlich, wenn userId dem anfragenden Nutzer entspricht. Er kann weggelassen werden, wenn der anfragende Nutzer Administratorberechtigungen hat, um Schüler/Studenten für jeden Nutzer zu erstellen.

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.