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 hinzu.

Domainadministratoren dürfen Nutzer in ihrer Domain direkt als Teilnehmer zu Kursen in ihrer Domain hinzufügen. Schüler und Studenten können sich mit einem Registrierungscode in einem Kurs anmelden.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn der anfragende Nutzer nicht berechtigt ist, in diesem Kurs Lernende zu erstellen, oder für Zugriffsfehler.
  • NOT_FOUND, wenn die angeforderte Kurs-ID nicht vorhanden ist.
  • FAILED_PRECONDITION, wenn das Konto des angefragten Nutzers für die folgenden Anfragefehler deaktiviert ist:
    • Kurslimit erreicht
    • Kurs nicht änderbar
    • UserGroupsMemberLimitLimit erreicht
    • InaktivKursinhaber
  • 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

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

Abfrageparameter

Parameter
enrollmentCode

string

Der Registrierungscode 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 über Administratorberechtigungen verfügt, um 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 in der Übersicht zu OAuth 2.0.