Google 课堂插件现已面向开发者正式推出!如需了解详情,请参阅
插件文档。
Method: courses.students.create
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
将用户添加为课程的学生。
网域管理员可以直接添加网域内的用户作为学生加入网域内的课程。学生可以使用注册代码将自己添加到课程中。
此方法会返回以下错误代码:
- 如果请求的用户无权在此课程中创建学生,或者因访问权限错误而无法创建学生,则返回
PERMISSION_DENIED
。
- 如果请求的课程 ID 不存在,则返回
NOT_FOUND
。
FAILED_PRECONDITION
如果请求的用户的账号已停用,则会出现以下请求错误:
- CourseMemberLimitReached
- CourseNotModifiable
- UserGroupsMembershipLimitReached
- InactiveCourseOwner
- 如果用户已是课程的学生或教师,则为
ALREADY_EXISTS
。
HTTP 请求
POST https://classroom.googleapis.com/v1/courses/{courseId}/students
网址采用 gRPC 转码语法。
路径参数
参数 |
courseId |
string
要创建学生的课程的标识符。此标识符可以是 Google 课堂分配的标识符,也可以是 alias 。
|
查询参数
参数 |
enrollmentCode |
string
要为其创建学生的课程的注册代码。如果 userId 与请求创建学生的用户相对应,则必须提供此代码;如果请求创建学生的用户拥有为任何用户创建学生的管理员权限,则可以省略此代码。
|
请求正文
请求正文包含一个 Student
实例。
响应正文
如果成功,响应正文将包含一个新创建的 Student
实例。
授权范围
需要以下 OAuth 范围之一:
https://www.googleapis.com/auth/classroom.rosters
https://www.googleapis.com/auth/classroom.profile.emails
https://www.googleapis.com/auth/classroom.profile.photos
如需了解详情,请参阅授权指南。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-04-17。
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-04-17。"],[],[]]