Google 课堂插件现已面向开发者正式推出!如需了解详情,请参阅
插件文档。
Method: courses.students.delete
删除课程的学生。
此方法会返回以下错误代码:
- 如果请求删除的用户不被允许删除此课程的学生,或者因访问权限错误而无法删除,则返回
PERMISSION_DENIED
。
- 如果此课程的任何学生都没有请求的 ID 或该课程不存在,则返回
NOT_FOUND
。
HTTP 请求
DELETE https://classroom.googleapis.com/v1/courses/{courseId}/students/{userId}
网址采用 gRPC 转码语法。
路径参数
参数 |
courseId |
string
课程的标识符。此标识符可以是 Google 课堂分配的标识符,也可以是 alias 。
|
userId |
string
要删除的学生的标识符。标识符可以是以下各项之一:
- 用户的数字标识符
- 用户的电子邮件地址
- 字符串字面量
"me" ,表示请求用户
|
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/classroom.rosters
如需了解详情,请参阅授权指南。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-12-05。
[null,null,["最后更新时间 (UTC):2024-12-05。"],[[["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."]]],[]]