Method: courses.create

创建课程。

ownerId 中指定的用户是所创建课程的所有者，并已添加为教师。非管理员请求用户只能创建以自己为所有者的课程。网域管理员可以创建由其网域中的任何用户拥有的课程。

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

  • PERMISSION_DENIED 如果请求用户无权创建课程，或出现访问错误。
  • NOT_FOUND 如果主讲教师不是有效用户。
  • FAILED_PRECONDITION 如果课程所有者的账号被停用，或者出现以下请求错误：
    • UserCannotOwnCourse
    • UserGroupsMembershipLimitReached
    • CourseTitleCannotContainUrl
  • 如果别名已在 id 中指定且已存在，则为 ALREADY_EXISTS。

HTTP 请求

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

网址采用 gRPC 转码语法。

请求正文

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

响应正文

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

授权范围

需要以下 OAuth 范围：

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

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