您的用户是通过 Google Meet 使用 Google 课堂吗？请查看 Apps 脚本快速入门 - 了解如何在 Google Meet 课程中查看学生出席情况。

Method: courses.topics.patch

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

更新主题的一个或多个字段。

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

  • 如果发出请求的开发者项目未创建相应的主题或存在访问错误，则返回 PERMISSION_DENIED。
  • 如果请求的格式不正确，则返回 INVALID_ARGUMENT。
  • 如果请求的课程或主题不存在，则返回 NOT_FOUND

HTTP 请求

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/topics/{id}

网址采用 gRPC 转码语法。

路径参数

参数
courseId

string

课程的标识符。此标识符可以是 Google 课堂分配的标识符，也可以是 alias。
id

string

主题的标识符。

查询参数

参数
updateMask

string (FieldMask format)

标识要更新的主题的字段的掩码。执行更新时必须填写此字段。如果指定了无效字段，更新将会失败。如果某个字段支持空值，可以通过在更新掩码中指定字段（而不是在 Topic 对象中）来清除该字段。如果更新掩码中包含不支持空值的字段，并且该字段未在 Topic 对象中设置，则返回 INVALID_ARGUMENT 错误。

可指定以下字段：

  • name

这是一个以逗号分隔的完全限定字段名称的列表。示例："user.displayName,photo"。

请求正文

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

响应正文

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

授权范围

需要以下 OAuth 作用域：

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

有关详情，请参阅 OAuth 2.0 概览。