Method: courses.create

创建课程。

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

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

  • 如果发出请求的用户无法创建课程或出现访问错误，则为 PERMISSION_DENIED。
  • 如果主讲教师不是有效用户，则为 NOT_FOUND。
  • FAILED_PRECONDITION如果课程所有者的帐号被停用或出现以下请求错误：
    • 用户无法拥有的课程
    • 用户群组成员资格限制已覆盖
  • 如果 id 中指定了别名，且别名已存在，则为 ALREADY_EXISTS。

HTTP 请求

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

网址采用 gRPC 转码语法。

请求正文

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

响应正文

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

授权范围

需要以下 OAuth 作用域：

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

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