REST Resource: courses.announcements

• 资源：公告
  • JSON 表示法
• 公告状态
• 方法

资源：公告

教师为课程学生创建的通知

JSON 表示法
{ "courseId": string, "id": string, "text": string, "materials": [ { object (Material) } ], "state": enum (AnnouncementState), "alternateLink": string, "creationTime": string, "updateTime": string, "scheduledTime": string, "assigneeMode": enum (AssigneeMode), "individualStudentsOptions": { object (IndividualStudentsOptions) }, "creatorUserId": string }

字段
courseId	string 课程的标识符。 只读。
id	string 此通知由 Google 课堂分配的标识符，每个课程具有唯一性。 只读。
text	string 此通知的说明。该文本必须是有效的 UTF-8 字符串，长度不超过 30,000 个字符。
materials[]	object (Material) 其他资料。 公告中的资料项不得超过 20 项。
state	enum (AnnouncementState) 此通知的状态。如果未指定该属性，则默认状态为 DRAFT。
alternateLink	string Google 课堂网页界面中指向此通知的绝对链接。仅当 state 为 PUBLISHED 时填充此字段。 只读。
creationTime	string (Timestamp format) 创建此通告时的时间戳。 只读。 时间戳采用 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式，分辨率为纳秒，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
updateTime	string (Timestamp format) 最近对此通告进行更改的时间戳。 只读。 时间戳采用 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式，分辨率为纳秒，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
scheduledTime	string (Timestamp format) 计划发布此公告时的可选时间戳。 时间戳采用 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式，分辨率为纳秒，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
assigneeMode	enum (AssigneeMode) 通知的分配对象模式。如果未指定值，默认值为 ALL_STUDENTS。
individualStudentsOptions	object (IndividualStudentsOptions) 有权访问通知的学生标识符。仅当 assigneeMode 为 INDIVIDUAL_STUDENTS 时，此字段才设置。如果 assigneeMode 为 INDIVIDUAL_STUDENTS，则只有此字段中指定的学生才能看到通知。
creatorUserId	string 创建通知的用户的标识符。 只读。

公告状态

可能的通告状态

枚举
ANNOUNCEMENT_STATE_UNSPECIFIED	未指定状态。永远不会返回。
PUBLISHED	已发布通知的状态。这是默认状态。
DRAFT	通知尚未发布的状态。只有课程教师和网域管理员才能看到此状态的通知。
DELETED	已发布但现已删除的通知状态。只有课程教师和网域管理员才能看到此状态的通知。此状态的通知会在一段时间后删除。

方法
create	创建通知。
delete	删除通知。
get	返回通知。
list	返回请求者可以查看的通告列表。
modifyAssignees	修改分配对象模式和通知选项。
patch	更新通知的一个或多个字段。