更新主题的一个或多个字段。
此方法会返回以下错误代码:
- 如果发出请求的开发者项目未创建相应的主题或存在访问错误,则返回
PERMISSION_DENIED
。 - 如果请求的格式不正确,则返回
INVALID_ARGUMENT
。 - 如果请求的课程或主题不存在,则返回
NOT_FOUND
HTTP 请求
PATCH https://classroom.googleapis.com/v1/courses/{courseId}/topics/{id}
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
courseId |
课程的标识符。此标识符可以是 Google 课堂分配的标识符,也可以是 |
id |
主题的标识符。 |
查询参数
参数 | |
---|---|
updateMask |
标识要更新的主题的字段的掩码。执行更新时必须填写此字段。如果指定了无效字段,更新将会失败。如果某个字段支持空值,可以通过在更新掩码中指定字段(而不是在 Topic 对象中)来清除该字段。如果更新掩码中包含不支持空值的字段,并且该字段未在 Topic 对象中设置,则返回 可指定以下字段:
这是一个以逗号分隔的完全限定字段名称的列表。示例: |
请求正文
请求正文包含一个 Topic
实例。
响应正文
如果成功,响应正文将包含一个 Topic
实例。
授权范围
需要以下 OAuth 作用域:
https://www.googleapis.com/auth/classroom.topics
有关详情,请参阅 OAuth 2.0 概览。