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.

Abfrageparameter

Parameter
previewVersion

enum (PreviewVersion)

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

Anfragetext

Der Anfragetext enthält eine Instanz von StudentGroup.

Antworttext

Bei Erfolg 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.