Verwenden Ihre Nutzer Classroom mit Google Meet? Sehen Sie sich die Apps Script-Kurzanleitung zum Ansehen der Teilnahme von Schülern/Studenten in Google Meet-Kursen an.

Method: courses.students.create

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Fügt einen Nutzer als Kursteilnehmer eines Kurses hinzu.

Domainadministratoren dürfen Nutzer in der Domain als Schüler oder Studenten zu Kursen in ihrer Domain direkt hinzufügen. Schüler und Studenten dürfen sich mithilfe eines Registrierungscodes selbst zu einem Kurs hinzufügen.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn der anfragende Nutzer in diesem Kurs keine Schüler oder Studenten erstellen darf oder bei Zugriffsfehlern die Berechtigung hat.
  • NOT_FOUND, wenn die angeforderte Kurs-ID nicht vorhanden ist.
  • FAILED_PRECONDITION, wenn das Konto des angeforderten Nutzers deaktiviert ist, für die folgenden Anfragefehler:
    • KursmitgliedLimitiert
    • Kurs NotModable
    • UserGroupsMembershipLimitReached
    • InaktivCourseOwner
  • ALREADY_EXISTS, wenn der Nutzer bereits Schüler/Student oder Lehrkraft ist.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
courseId

string

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

Suchparameter

Parameter
enrollmentCode

string

Anmeldecode des Kurses, in dem der Schüler 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 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 in der OAuth 2.0-Übersicht.