您的用户是通过 Google Meet 使用 Google 课堂吗?请查看 Apps 脚本快速入门 - 了解如何在 Google Meet 课程中查看学生出席情况

REST Resource: courses.announcements

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

资源:公告

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

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

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)

有权访问通知的学生标识符。仅当 assigneeModeINDIVIDUAL_STUDENTS 时,此字段才设置。如果 assigneeModeINDIVIDUAL_STUDENTS,则只有此字段中指定的学生才能看到通知。

creatorUserId

string

创建通知的用户的标识符。

只读。

公告状态

可能的通告状态

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

方法

create

创建通知。

delete

删除通知。

get

返回通知。

list

返回请求者可以查看的通告列表。

modifyAssignees

修改分配对象模式和通知选项。

patch

更新通知的一个或多个字段。