Method: courses.studentGroups.delete

Löscht eine Schüler‑/Studentengruppe.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn der anfragende Nutzer nicht berechtigt ist, die angeforderte Schülergruppe zu löschen, oder bei Zugriffsfehlern.
  • NOT_FOUND, wenn die Schülergruppe nicht vorhanden ist oder der Nutzer keinen Zugriff darauf hat.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
courseId

string

Erforderlich. Die ID des Kurses, der die zu löschende Schüler-/Studentengruppe enthält.
id

string

Erforderlich. Die ID der zu löschenden 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 muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, ist der Antworttext ein leeres JSON-Objekt.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie im Autorisierungsleitfaden.