工具:create_topic
在課程中建立新主題。主題可用來整理課程作業。必須具備課程中的老師角色。
以下程式碼範例說明如何使用 curl 呼叫 create_topic 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_topic", "arguments": { // Provide these details according to the MCP tool specification. } }, "jsonrpc": "2.0", "id": 1 }' |
輸入內容的結構定義
要求在課程中建立主題。
CreateTopicRequest
| JSON 表示法 |
|---|
{ "courseId": string, "title": string } |
| 欄位 | |
|---|---|
courseId |
必填。課程 ID。 |
title |
必填。主題名稱。不得超過 100 個半形字元。 |
輸出內容的結構定義
課程中的主題。
主題
| JSON 表示法 |
|---|
{ "id": string, "title": string } |
| 欄位 | |
|---|---|
id |
僅供輸出。ID。主題 ID。 |
title |
主題名稱。 |
工具註解
工具註解會傳送至 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.topics