Công cụ: create_topic
Tạo một chủ đề mới trong khoá học. Chủ đề được dùng để sắp xếp tài liệu môn học. Bạn phải có vai trò giáo viên trong khoá học.
Mã mẫu sau đây cho biết cách sử dụng curl để gọi công cụ MCP create_topic.
| Yêu cầu 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 }' |
Giản đồ đầu vào
Yêu cầu tạo một chủ đề trong khoá học.
CreateTopicRequest
| Biểu diễn dưới dạng JSON |
|---|
{ "courseId": string, "title": string } |
| Trường | |
|---|---|
courseId |
Bắt buộc. Giá trị nhận dạng của khoá học. |
title |
Bắt buộc. Tiêu đề của chủ đề. Phải có tối đa 100 ký tự. |
Giản đồ đầu ra
Một chủ đề trong khoá học.
Chủ đề
| Biểu diễn dưới dạng JSON |
|---|
{ "id": string, "title": string } |
| Trường | |
|---|---|
id |
Chỉ có đầu ra. Giá trị nhận dạng. Mã chủ đề. |
title |
Tiêu đề của chủ đề. |
Chú thích về công cụ
Chú thích về công cụ được gửi đến ứng dụng MCP để mô tả rủi ro cơ bản của một công cụ nhất định. Hầu hết ứng dụng đều coi những gợi ý này là không đáng tin cậy, nhưng có thể dùng chúng để quyết định thời điểm gửi lời nhắc xác nhận cho người dùng.
Cùng với chuỗi tiêu đề, các gợi ý boolean sau đây được xác định như sau:
readOnlyHint: Nếu đúng, công cụ sẽ không sửa đổi môi trường của nó. Mặc định: false.destructiveHint: Nếu đúng, thì công cụ có thể thực hiện các hành động có tính huỷ diệt. Nếu là false, thì công cụ chỉ có thể thực hiện các hành động bổ sung. Mặc định: true.idempotentHint: Nếu đúng, thì việc gọi công cụ nhiều lần với cùng một đối số sẽ không có thêm hiệu ứng nào đối với môi trường của công cụ đó. Mặc định: false.openWorldHint: Nếu đúng, thì công cụ này có thể tương tác với "thế giới mở" của các thực thể bên ngoài. Nếu là false, thì công cụ chỉ có thể tương tác với các thực thể nội bộ. Ví dụ: công cụ tìm kiếm trên web sẽ là công cụ thế giới mở, còn công cụ ghi nhớ sẽ không phải là công cụ thế giới mở.
Gợi ý về hành động huỷ bỏ: ❌ | Gợi ý về hành động luỹ đẳng: ❌ | Gợi ý về hành động chỉ đọc: ❌ | Gợi ý về hành động thế giới mở: ❌
Phạm vi cấp phép
Yêu cầu một trong các phạm vi OAuth sau:
https://www.googleapis.com/auth/classroom.topics