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

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