Method: courses.studentGroups.studentGroupMembers.create

为学生群组创建学生群组成员。

此方法会返回以下错误代码：

  • PERMISSION_DENIED 如果请求用户无权创建学生群组或成员，则返回访问权限错误。
  • NOT_FOUND 如果学生群组不存在或用户无权访问学生群组。
  • 如果学生群组成员已存在，则为 ALREADY_EXISTS。
  • FAILED_PRECONDITION 如果尝试向已达到成员上限的学生群组添加成员。

HTTP 请求

POST https://classroom.googleapis.com/v1/courses/{courseId}/studentGroups/{studentGroupId}/studentGroupMembers

网址采用 gRPC 转码语法。

路径参数

参数
courseId

string

必需。课程的标识符。
studentGroupId

string

必需。学生群组的标识符。

查询参数

参数
previewVersion

enum (PreviewVersion)

可选。API 的预览版。必须设置此标志，才能访问预览版计划中向开发者提供的新 API 功能。

请求正文

请求正文包含一个 StudentGroupMember 实例。

响应正文

如果成功，响应正文将包含一个新创建的 StudentGroupMember 实例。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/classroom.rosters

如需了解详情，请参阅授权指南。