Method: courses.create

创建课程。

ownerId 中指定的用户是所创建课程的所有者,且已添加为教师。非管理员申请用户只能创建以自己为所有者的课程。网域管理员可以创建归网域内任何用户所有的课程。

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

  • 如果发出请求的用户无权创建课程或发生访问错误,则使用 PERMISSION_DENIED
  • 如果主讲教师不是有效的用户,则为 NOT_FOUND
  • 如果课程所有者的帐号已停用或由于出现以下请求错误,则使用 FAILED_PRECONDITION
    • UserCannotOwnCourse
    • UserGroupsMembershipLimitReached
  • 如果 id 中指定了别名且已存在,则返回 ALREADY_EXISTS

HTTP 请求

POST https://classroom.googleapis.com/v1/courses

网址采用 gRPC 转码语法。

请求正文

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

响应正文

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

授权范围

需要以下 OAuth 作用域:

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

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