資源:公告
由老師為課程學生建立的公告
JSON 表示法 |
---|
{ "courseId": string, "id": string, "text": string, "materials": [ { object ( |
欄位 | |
---|---|
courseId |
課程的 ID。 唯讀。 |
id |
Classroom 指派給這個公告的 ID,每個課程均有專屬的 ID。 唯讀。 |
text |
這項公告的說明。文字必須是 UTF-8 字串,且最多只能包含 30,000 個半形字元。 |
materials[] |
其他資料。 公告最多只能有 20 個教材項目。 |
state |
這項公告的狀態,如果未指定,則預設狀態為 |
alternateLink |
Classroom 網頁使用者介面中的公告絕對連結。只有在 唯讀。 |
creationTime |
建立這則公告時的時間戳記。 唯讀。 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度,且最多 9 個小數位數。範例: |
updateTime |
這則公告最近變更的時間戳記。 唯讀。 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度,且最多 9 個小數位數。範例: |
scheduledTime |
(選填) 排定發布這則公告的時間。 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度,且最多 9 個小數位數。範例: |
assigneeMode |
公告的指派對像模式。如果未指定,則預設值為 |
individualStudentsOptions |
具備公告存取權的學生 ID。只有在 |
creatorUserId |
建立公告的使用者 ID。 唯讀。 |
AnnouncementState
可能的公告狀態
列舉 | |
---|---|
ANNOUNCEMENT_STATE_UNSPECIFIED |
未指定州。系統絕不會傳回這個內容。 |
PUBLISHED |
已發布公告的狀態。此為預設狀態。 |
DRAFT |
尚未發布的公告狀態。只有課程老師和網域管理員才能查看這個狀態的公告。 |
DELETED |
公告狀態:已發布但現已刪除。只有課程老師和網域管理員才能查看這個狀態的公告。這個狀態的公告會在一段時間後刪除。 |
方法 |
|
---|---|
|
建立公告。 |
|
刪除公告。 |
|
傳回公告。 |
|
取得 Classroom 外掛程式與特定訊息相關的中繼資料。 |
|
傳回允許要求者查看的公告清單。 |
|
修改公告的指派對像模式和選項。 |
|
更新公告的一或多個欄位。 |