REST Resource: invitations

资源:邀请

一条加入课程的邀请。

JSON 表示法
{
  "id": string,
  "userId": string,
  "courseId": string,
  "role": enum (CourseRole)
}
字段
id

string

由 Google 课堂分配的标识符。

只读。

userId

string

受邀用户的标识符。

当指定为请求的参数时,此标识符可设置为以下其中一项:

  • 用户的数字标识符
  • 用户的电子邮件地址
  • 字符串字面量 "me",表示发出请求的用户
courseId

string

邀请用户参加的课程的标识符。

role

enum (CourseRole)

要邀请用户拥有的角色。不得为 COURSE_ROLE_UNSPECIFIED

CourseRole

用户可能受邀担任的角色。

枚举
COURSE_ROLE_UNSPECIFIED 无课程角色。
STUDENT 课程中的学生。
TEACHER 课程的教师。
OWNER 课程的所有者。

方法

accept

接受邀请,移除邀请并将受邀用户添加到指定课程的教师或学生(视情况而定)。

create

创建邀请。

delete

删除邀请。

get

返回邀请。

list

返回发出请求的用户可以查看的邀请列表(仅限与列表请求相匹配的邀请)。