工具:create_announcement
在课程信息流中创建新通知。需要拥有课程中的教师角色。创建的通知始终为学生无法看到的草稿;如果设置了 scheduleDate,则会在该日期自动发布。否则,请告知用户在 Google 课堂中发布,因为此工具无法发布通知。
Google 课堂没有指向单个草稿通知的网页链接。如需将用户链接到新通知,请使用课程信息流页面 https://classroom.google.com/c/{course_id},教师可以在“草稿”部分找到该通知,以便进行审核或发布。请严格按照返回的 ID 使用,切勿猜测或修改。
以下代码示例展示了如何使用 curl 调用 create_announcement 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": "create_announcement", "arguments": { // Provide these details according to the MCP tool specification. } }, "jsonrpc": "2.0", "id": 1 }' |
输入架构
请求创建公告。
CreateAnnouncementRequest
| JSON 表示法 |
|---|
{
"courseId": string,
"text": string,
"materials": [
{
object ( |
| 字段 | |
|---|---|
courseId |
必需。课程的标识符。 |
text |
必需。通知的文本。 |
materials[] |
可选。要附加的资料。最多 20 个。 |
assigneeIds[] |
可选。可查看通知的学生的标识符,来自 get_course_roster。留空表示所有学生。 |
scheduleDate |
可选。自动发布公告的日期 (YYYY-MM-DD)。时间默认为用户所在时区的上午 8 点,可在界面中修改。 |
timeZone |
必需。用户的 IANA 时区(例如 |
MaterialInput
| JSON 表示法 |
|---|
{ "driveFile": { object ( |
| 字段 | |
|---|---|
联合字段 content。附件内容。content 只能是下列其中一项: |
|
driveFile |
要附加的 Google 云端硬盘文件。 |
youtubeVideoId |
要附加的 YouTube 视频的标识符(例如 |
linkUrl |
要附加的网页的网址。 |
formUrl |
要附加的 Google 表单的网址。 |
notebook |
要附加的 Gemini Notebook。 |
DriveFileInput
| JSON 表示法 |
|---|
{
"id": string,
"shareMode": enum ( |
| 字段 | |
|---|---|
id |
必需。云端硬盘文件的标识符。 |
shareMode |
必需。学生获取文件的方式:查看(只读)、编辑(所有人编辑同一文件)或复制(每位学生都会获得自己的副本)。 |
GeminiNotebook
| JSON 表示法 |
|---|
{ "id": string, "title": string } |
| 字段 | |
|---|---|
id |
必需。Notebook 的标识符。 |
title |
笔记本的标题。 |
云端硬盘文件的共享设置。
| 枚举 | |
|---|---|
SHARE_MODE_UNSPECIFIED |
未指定共享模式。 |
VIEW |
学生可以查看共享的文件。 |
EDIT |
学生可以编辑共享文件。 |
COPY |
学生会收到共享文件的个人副本。 |
输出架构
通知的详细元数据。
通知
| JSON 表示法 |
|---|
{ "id": string, "materials": [ { object ( |
| 字段 | |
|---|---|
id |
仅限输出。标识符。公告 ID。 |
materials[] |
此通知中附加的资料。 |
assigneeIds[] |
可以看到此通知的学生 ID 列表(未设置表示所有学生)。 |
publishDate |
仅限输出。公告发布日期 (YYYY-MM-DD)。 |
state |
仅限输出。通知的状态。 |
text |
通知的文本。 |
scheduleDate |
公告的预定发布日期 (YYYY-MM-DD)。时间默认为用户所在时区的上午 8 点,可在界面中修改。 |
材质
| JSON 表示法 |
|---|
{ "id": string, "sharedDriveFile": { object ( |
| 字段 | |
|---|---|
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 |
必需。云端硬盘文件的标识符。 |
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 的标识符。 |
title |
笔记本的标题。 |
云端硬盘文件的共享设置。
| 枚举 | |
|---|---|
SHARE_MODE_UNSPECIFIED |
未指定共享模式。 |
VIEW |
学生可以查看共享的文件。 |
EDIT |
学生可以编辑共享文件。 |
COPY |
学生会收到共享文件的个人副本。 |
州
通知的状态。
| 枚举 | |
|---|---|
STATE_UNSPECIFIED |
未指定状态。 |
PUBLISHED |
通知已发布,学生可以看到。 |
DRAFT |
通知为草稿。 |
工具注释
工具注解会发送到 MCP 客户端,用于描述给定工具的基本风险。大多数客户端会将这些提示视为不可信,但它们可用于决定何时向用户发送确认提示。
除了标题字符串之外,还定义了以下布尔值提示:
readOnlyHint:如果为 true,则该工具不会修改其环境。默认值:false。destructiveHint:如果为 true,则该工具可以执行破坏性操作。如果为 false,则该工具只能执行添加操作。默认值:true。idempotentHint:如果为 true,则使用相同参数重复调用该工具不会对其环境产生额外影响。默认值:false。openWorldHint:如果为 true,则该工具可以与外部实体的“开放世界”进行交互。如果为 false,则该工具只能与内部实体交互。例如,网页搜索工具是开放式的,而记忆工具不是开放式的。
破坏性提示:❌ | 幂等性提示:❌ | 只读提示:❌ | 开放世界提示:❌
授权范围
需要以下 OAuth 范围之一:
https://www.googleapis.com/auth/classroom.announcements