工具:get_announcements
依 ID 擷取課程中一或多則公告的全文、附加教材、指派對象和狀態。使用 list_announcement_summaries 找出公告並擷取其 ID。
以下程式碼範例說明如何使用 curl 呼叫 get_announcements MCP 工具。
| Curl 要求 |
|---|
curl --location 'https://classroommcp.googleapis.com/mcp/v1' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/call", "params": { "name": "get_announcements", "arguments": { // Provide these details according to the MCP tool specification. } }, "jsonrpc": "2.0", "id": 1 }' |
輸入內容的結構定義
要求取得公告詳細資料。
GetAnnouncementsRequest
| JSON 表示法 |
|---|
{ "courseId": string, "announcementIds": [ string ], "timeZone": string } |
| 欄位 | |
|---|---|
courseId |
必填。課程 ID。 |
announcementIds[] |
必填。公告的 ID。每項要求最多 50 個 ID。 |
timeZone |
必填。使用者的 IANA 時區 (例如 |
輸出內容的結構定義
包含公告詳細資料的回應。
GetAnnouncementsResponse
| JSON 表示法 |
|---|
{
"announcements": [
{
object ( |
| 欄位 | |
|---|---|
announcements[] |
擷取的公告清單。 |
公告
| JSON 表示法 |
|---|
{ "id": string, "materials": [ { object ( |
| 欄位 | |
|---|---|
id |
僅供輸出。ID。公告 ID。 |
materials[] |
這則公告附加的教材。 |
assigneeIds[] |
可查看這則公告的學生 ID 清單 (未設定代表所有學生)。 |
publishDate |
僅供輸出。公告發布日期 (YYYY-MM-DD)。 |
state |
僅供輸出。公告狀態。 |
text |
公告文字。 |
scheduleDate |
公告預定發布日期 (YYYY-MM-DD)。時間預設為使用者時區的上午 8 點,可在使用者介面中編輯。 |
材質
| JSON 表示法 |
|---|
{ "id": string, "sharedDriveFile": { object ( |
| 欄位 | |
|---|---|
id |
僅供輸出。教材 ID。使用 |
聯集欄位 content。附件內容。content 只能是下列其中一項: |
|
sharedDriveFile |
Google 雲端硬碟檔案附件。 |
youtubeVideo |
YouTube 影片附件。 |
link |
網址連結附件。 |
form |
Google 表單附件。 |
notebook |
Gemini Notebook 附件。 |
| JSON 表示法 |
|---|
{ "file": { object ( |
| 欄位 | |
|---|---|
file |
雲端硬碟檔案詳細資料。 |
shareMode |
必填。學生取得檔案的方式:查看 (唯讀)、編輯 (所有人編輯同一個檔案) 或複製 (每位學生取得自己的副本)。 |
DriveFile
| JSON 表示法 |
|---|
{ "id": string, "title": string, "url": string } |
| 欄位 | |
|---|---|
id |
必填。雲端硬碟檔案的 ID。 |
title |
僅供輸出。雲端硬碟檔案的標題。 |
url |
僅供輸出。雲端硬碟檔案的網址。 |
YouTubeVideo
| JSON 表示法 |
|---|
{ "id": string, "title": string } |
| 欄位 | |
|---|---|
id |
必填。YouTube 影片 ID。 |
title |
僅供輸出。YouTube 影片的標題。 |
連結
| JSON 表示法 |
|---|
{ "url": string, "title": string } |
| 欄位 | |
|---|---|
url |
必填。連結的網址。 |
title |
僅供輸出。連結標題。 |
表單
| JSON 表示法 |
|---|
{ "formUrl": string, "title": string, "responseUrl": string } |
| 欄位 | |
|---|---|
formUrl |
必填。表單網址。 |
title |
僅供輸出。表單標題。 |
responseUrl |
僅供輸出。表單回覆的網址。只有在已記錄回覆,且要求的使用者是表單編輯者時,才會設定。 |
GeminiNotebook
| JSON 表示法 |
|---|
{ "id": string, "title": string } |
| 欄位 | |
|---|---|
id |
必填。Notebook 的 ID。 |
title |
Notebook 的標題。 |
雲端硬碟檔案的共用設定。
| 列舉 | |
|---|---|
SHARE_MODE_UNSPECIFIED |
未指定共用模式。 |
VIEW |
學生可以查看共用檔案。 |
EDIT |
學生可以編輯共用檔案。 |
COPY |
學生會收到共用檔案的個人副本。 |
州
公告狀態。
| 列舉 | |
|---|---|
STATE_UNSPECIFIED |
未指定狀態。 |
PUBLISHED |
公告已發布,學生可以查看。 |
DRAFT |
公告為草稿。 |
工具註解
工具註解會傳送至 MCP 用戶端,說明特定工具的基本風險。大多數用戶端會將這些提示視為不受信任,但可用於決定何時向使用者傳送確認提示。
除了標題字串外,下列布林值提示的定義如下:
readOnlyHint:如果為 true,工具不會修改環境。預設值:false。destructiveHint:如果為 true,工具可以執行破壞性動作。如果為 false,則工具只能執行附加動作。預設值:true。idempotentHint:如果設為 true,則使用相同引數重複呼叫工具,不會對環境造成額外影響。預設值:false。openWorldHint:如果設為 true,工具就能與外部實體的「開放世界」互動。如果設為 false,工具只能與內部實體互動。舉例來說,網頁搜尋工具屬於開放世界,而記憶工具則不屬於開放世界。
Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/classroom.announcementshttps://www.googleapis.com/auth/classroom.announcements.readonly