Method: courses.studentGroups.create

Erstellt eine Schüler‑/Studentengruppe für einen Kurs.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn der anfragende Nutzer nicht berechtigt ist, die Schülergruppe zu erstellen, oder bei Zugriffsfehlern.
  • NOT_FOUND, wenn der Kurs nicht vorhanden ist oder der anfragende Nutzer keinen Zugriff auf den Kurs hat.
  • FAILED_PRECONDITION, wenn die maximale Anzahl von Schüler‑/Studentengruppen pro Kurs überschritten würde.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
courseId

string

Erforderlich. Die Kennung des Kurses.

Suchparameter

Parameter
previewVersion

enum (PreviewVersion)

Optional. Die Preview-Version der API. Diese Einstellung ist erforderlich, um auf neue API-Funktionen zuzugreifen, die Entwicklern im Vorabzugriffsprogramm zur Verfügung gestellt werden.

Anfragetext

Der Anfragetext enthält eine Instanz von StudentGroup.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine neu erstellte Instanz von StudentGroup.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/classroom.rosters

Weitere Informationen finden Sie im Autorisierungsleitfaden.