MCP Tools Reference: classroommcp.googleapis.com

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

string

Bắt buộc. Giá trị nhận dạng của khoá học.

title

string

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

string

Chỉ có đầu ra. Giá trị nhận dạng. Mã chủ đề.

title

string

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