Method: courses.students.create

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

string

ID des Kurses, in dem der Teilnehmer erstellt werden soll. Diese Kennung kann entweder die von Classroom zugewiesene ID oder eine alias sein.

Abfrageparameter

Parameter
enrollmentCode

string

Einschreibungscode 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 einen beliebigen 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.