Google Classroom-Add-ons sind jetzt allgemein für Entwickler verfügbar. Weitere Informationen finden Sie in der
Dokumentation zu Add-ons.
Method: courses.students.delete
Löscht einen Kursteilnehmer.
Diese Methode gibt die folgenden Fehlercodes zurück:
PERMISSION_DENIED
, wenn der anfragende Nutzer nicht berechtigt ist, Teilnehmer dieses Kurses zu löschen, oder wenn Zugriffsfehler aufgetreten sind.
NOT_FOUND
, wenn kein Teilnehmer 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
ID des Kurses. Diese Kennung kann entweder die von Classroom zugewiesene ID oder eine alias sein.
|
userId |
string
ID des zu löschenden Schülers/Studenten. Folgende Kennzeichnungen sind möglich:
- Numerische Kennung des Nutzers
- die E-Mail-Adresse des Nutzers
- das String-Literal
"me" , das den anfragenden Nutzer angibt
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Wenn der Vorgang erfolgreich ist, ist der Antworttext leer.
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/classroom.rosters
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-02-27 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-02-27 (UTC)."],[[["Deletes a specified student from a given course using their ID."],["Requires authorization with the `https://www.googleapis.com/auth/classroom.rosters` scope."],["Returns an error if the user lacks permission, the student or course is not found, or there are access issues."],["Uses a DELETE request to the endpoint `https://classroom.googleapis.com/v1/courses/{courseId}/students/{userId}` with course and student IDs as path parameters."],["The request body should be empty, and a successful deletion results in an empty response body."]]],[]]