资源:Announcement
教师为课程学生创建的通知
JSON 表示法 |
---|
{ "courseId": string, "id": string, "text": string, "materials": [ { object ( |
字段 | |
---|---|
courseId |
课程的标识符。 只读。 |
id |
相应公告的 Classroom 分配标识符,每个课程均唯一。 只读。 |
text |
相应公告的说明。文本必须是有效的 UTF-8 字符串,且不得超过 30,000 个字符。 |
materials[] |
其他资料。 公告不得包含超过 20 个素材资源。 |
state |
相应公告的状态。如果未指定,则默认状态为 |
alternateLink |
Google 课堂网页界面中此通知的绝对链接。仅当 只读。 |
creationTime |
相应公告的创建时间戳。 只读。 采用 RFC 3339 标准,生成的输出将始终在末尾带 Z,并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例: |
updateTime |
相应公告的最近一次更改的时间戳。 只读。 采用 RFC 3339 标准,生成的输出将始终在末尾带 Z,并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例: |
scheduledTime |
此公告计划发布的可选时间戳。 采用 RFC 3339 标准,生成的输出将始终在末尾带 Z,并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例: |
assigneeMode |
公告的分配对象模式。如果未指定,则默认值为 |
individualStudentsOptions |
有权访问相应公告的学生的标识符。只有当 |
creatorUserId |
创建公告的用户的标识符。 只读。 |
AnnouncementState
公告的可能状态
枚举 | |
---|---|
ANNOUNCEMENT_STATE_UNSPECIFIED |
未指定状态。此值永远不会返回。 |
PUBLISHED |
已发布公告的状态。这是默认状态。 |
DRAFT |
尚未发布的公告的状态。处于此状态的公告仅对课程教师和网域管理员可见。 |
DELETED |
已发布但现已删除的公告的状态。处于此状态的公告仅对课程教师和网域管理员可见。处于此状态的公告会在一段时间后被删除。 |
方法 |
|
---|---|
|
创建公告。 |
|
删除通知。 |
|
返回通知。 |
|
获取特定帖子上下文中 Google 课堂插件的元数据。 |
|
返回请求者有权查看的公告列表。 |
|
修改公告的分配对象模式和选项。 |
|
更新公告的一个或多个字段。 |