Method: courses.students.delete

Löscht einen Schüler/Studenten aus einem Kurs.

Diese Methode gibt die folgenden Fehlercodes zurück:

  • PERMISSION_DENIED, wenn der anfragende Nutzer keine Schüler/Studenten dieses Kurses löschen darf, oder aufgrund von Zugriffsfehlern.
  • NOT_FOUND, wenn kein Schüler oder Student dieses Kurses die angeforderte ID hat oder der Kurs nicht existiert.

HTTP-Anfrage

DELETE https://classroom.googleapis.com/v1/courses/{courseId}/students/{userId}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
courseId

string

Kennung des Kurses. Diese Kennung kann entweder die in Classroom zugewiesene Kennung oder eine alias sein.
userId

string

Die Kennung des Schülers oder Studenten, der gelöscht werden soll. Die Kennung kann eine der folgenden sein:

  • die numerische Kennung des Nutzers
  • E-Mail-Adresse des Nutzers
  • das Stringliteral "me", das den anfragenden Nutzer angibt

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 Leitfaden zur Autorisierung.