Method: courses.aliases.create

为课程创建别名。

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

  • 如果发出请求的用户无权创建别名或发生访问错误,则使用 PERMISSION_DENIED
  • 如果课程不存在,则为 NOT_FOUND
  • 如果别名已存在,则为 ALREADY_EXISTS
  • 如果请求的别名对发出请求的用户或课程没有意义(例如,如果网域以外的用户尝试访问网域范围的别名),则使用 FAILED_PRECONDITION

HTTP 请求

POST https://classroom.googleapis.com/v1/courses/{courseId}/aliases

网址采用 gRPC 转码语法。

路径参数

参数
courseId

string

要别名的课程的标识符。此标识符可以是 Google 课堂分配的标识符,也可以是 alias

请求正文

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

响应正文

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

授权范围

需要以下 OAuth 作用域:

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

有关详情,请参阅授权指南