Method: courses.studentGroups.studentGroupMembers.create

Erstellt ein Mitglied einer Schüler‑/Studentengruppe für eine Schüler‑/Studentengruppe.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn der anfragende Nutzer nicht berechtigt ist, die Schülergruppe oder das Mitglied zu erstellen, Zugriffsfehler.
  • NOT_FOUND, wenn die Schülergruppe nicht vorhanden ist oder der Nutzer keinen Zugriff darauf hat.
  • ALREADY_EXISTS, wenn das Mitglied der Schülergruppe bereits vorhanden ist.
  • FAILED_PRECONDITION, wenn Sie versuchen, einer Schülergruppe, die ihr Mitgliedslimit erreicht hat, ein Mitglied hinzuzufügen.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
courseId

string

Erforderlich. Die Kennung des Kurses.
studentGroupId

string

Erforderlich. Die Kennung der Schüler-/Studentengruppe.

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

Antworttext

Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von StudentGroupMember.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie im Autorisierungsleitfaden.