Google 课堂插件现已面向开发者正式推出!如需了解详情,请参阅
插件文档。
REST Resource: courses.topics
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
资源:主题
JSON 表示法 |
{
"courseId": string,
"topicId": string,
"name": string,
"updateTime": string
} |
字段 |
courseId |
string
课程的标识符。 只读。
|
topicId |
string
主题的唯一标识符。 只读。
|
name |
string
用户生成的主题的名称。开头和结尾的空格(如果有)会被去掉。此外,名称中的多个连续空格会合并为一个。结果必须是非空字符串。主题名称区分大小写,且不得超过 100 个字符。
|
updateTime |
string (Timestamp format)
主题上次由系统更新的时间。 只读。 采用 RFC 3339 标准,生成的输出将始终在末尾带 Z,并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例:"2014-10-02T15:01:23Z" 、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30" 。
|
方法 |
|
创建主题。 |
|
删除主题。 |
|
返回主题。 |
|
返回请求者有权查看的主题列表。 |
|
更新主题的一个或多个字段。 |
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-26。
[null,null,["最后更新时间 (UTC):2025-08-26。"],[],[],null,["- [Resource: Topic](#Topic)\n - [JSON representation](#Topic.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Topic Topic created by a teacher for the course\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------|\n| ``` { \"courseId\": string, \"topicId\": string, \"name\": string, \"updateTime\": string } ``` |\n\n| Fields ||\n|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `courseId` | `string` Identifier of the course. Read-only. |\n| `topicId` | `string` Unique identifier for the topic. Read-only. |\n| `name` | `string` The name of the topic, generated by the user. Leading and trailing whitespaces, if any, are trimmed. Also, multiple consecutive whitespaces are collapsed into one inside the name. The result must be a non-empty string. Topic names are case sensitive, and must be no longer than 100 characters. |\n| `updateTime` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` The time the topic was last updated by the system. Read-only. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`. |\n\n| Methods ||\n|------------------------------------------------------------------------|---------------------------------------------------------------------|\n| [create](/workspace/classroom/reference/rest/v1/courses.topics/create) | Creates a topic. |\n| [delete](/workspace/classroom/reference/rest/v1/courses.topics/delete) | Deletes a topic. |\n| [get](/workspace/classroom/reference/rest/v1/courses.topics/get) | Returns a topic. |\n| [list](/workspace/classroom/reference/rest/v1/courses.topics/list) | Returns the list of topics that the requester is permitted to view. |\n| [patch](/workspace/classroom/reference/rest/v1/courses.topics/patch) | Updates one or more fields of a topic. |"]]