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 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
- die E-Mail-Adresse des Nutzers
- das Stringliteral
"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: 2024-12-05 (UTC).
[null,null,["Zuletzt aktualisiert: 2024-12-05 (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."]]],[]]