Method: courses.update

更新课程。

注意：与其他字段不同，如果请求中省略了 levels，则不会清除该字段。只有在明确提供 levels 时，courses.update 方法才会修改 levels；否则，系统会保留现有值。使用 courses.patch 方法清除 levels 字段。

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

  • 如果请求用户无权修改所请求的课程，或者存在访问错误，则返回 PERMISSION_DENIED。
  • 如果不存在具有所请求 ID 的课程，则返回 NOT_FOUND。
  • FAILED_PRECONDITION，以解决以下请求错误：
    • CourseNotModifiable
    • CourseTitleCannotContainUrl

HTTP 请求

PUT https://classroom.googleapis.com/v1/courses/{id}

网址采用 gRPC 转码语法。

路径参数

参数
id

string

要更新的课程的标识符。此标识符可以是 Classroom 分配的标识符，也可以是 alias。

查询参数

参数
previewVersion

enum (PreviewVersion)

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

请求正文

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

响应正文

如果成功，则响应正文包含一个 Course 实例。

授权范围

需要以下 OAuth 范围：

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

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