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. Weitere Informationen finden Sie unter 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.

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

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, 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.