资源:公告
教师为课程中的学生创建的通知
JSON 表示法 |
---|
{ "courseId": string, "id": string, "text": string, "materials": [ { object ( |
字段 | |
---|---|
courseId |
课程的标识符。 只读。 |
id |
此通知由课堂分配的标识符,每门课程都是唯一的。 只读。 |
text |
此通知的说明。文本必须是有效的 UTF-8 字符串,且不得超过 30,000 个字符。 |
materials[] |
其他资料。 公告包含的重要内容不得超过 20 项。 |
state |
此通知的状态。如果未指定,则默认状态为 |
alternateLink |
Google 课堂网页界面中此通知的绝对链接。仅当 只读。 |
creationTime |
创建此通知时的时间戳。 只读。 时间戳,采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式,具有纳秒级分辨率,最多包含九个小数位。示例: |
updateTime |
此通知最近一次更改的时间戳。 只读。 时间戳,采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式,具有纳秒级分辨率,最多包含九个小数位。示例: |
scheduledTime |
计划发布此通知时的可选时间戳。 时间戳,采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式,具有纳秒级分辨率,最多包含九个小数位。示例: |
assigneeMode |
通知的分配对象模式。如果未指定,则默认值为 |
individualStudentsOptions |
有权访问通知的学生的标识符。仅当 |
creatorUserId |
创建通知的用户的标识符。 只读。 |
AnnouncementState
通知的可能状态
枚举 | |
---|---|
ANNOUNCEMENT_STATE_UNSPECIFIED |
未指定任何州。此值永远不会返回。 |
PUBLISHED |
已发布的通知的状态。这是默认状态。 |
DRAFT |
尚未发布的通知的状态。处于此状态的公告仅对课程教师和网域管理员可见。 |
DELETED |
已发布但现已删除的通知的状态。处于此状态的公告仅对课程教师和网域管理员可见。处于此状态的通知会在一段时间后被删除。 |
方法 |
|
---|---|
|
创建通知。 |
|
删除通知。 |
|
返回通知。 |
|
获取特定帖子上下文中的 Google 课堂插件元数据。 |
|
返回允许请求者查看的公告列表。 |
|
修改通知的分配对象模式和选项。 |
|
更新通知的一个或多个字段。 |