Method: courses.students.create
将用户添加为课程的学生。
网域管理员可以将用户直接添加到网域内的课程中的学生。学生可以使用注册代码自行加入课程。
此方法会返回以下错误代码:
- 如果请求的用户无权在此课程中创建学生或出现访问错误,则为
PERMISSION_DENIED
。
- 如果请求的课程 ID 不存在,则返回
NOT_FOUND
。
- 如果所请求用户的帐号因以下请求错误而遭到停用,则返回
FAILED_PRECONDITION
:
- 已达到 CourseMemberLimitLimited
- 课程不可修改
- 已达到 UserGroupsMembershipLimit
- ACTIVECourseOwner
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
有关详情,请参阅 OAuth 2.0 概览。
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2022-03-21 UTC.
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"没有我需要的信息"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"太复杂/步骤太多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"内容需要更新"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻译问题"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/代码问题"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"易于理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"解决了我的问题"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]