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 转码语法。

查询参数

参数
previewVersion

enum (PreviewVersion)

可选。API 的预览版本。必须设置此值，才能访问在试用计划中向开发者提供的新 API 功能。

请求正文

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

响应正文

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

授权范围

需要以下 OAuth 范围：

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

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