Alat: create_topic
Membuat topik baru dalam kursus. Topik digunakan untuk mengatur tugas mata pelajaran. Memerlukan peran pengajar dalam kursus.
Contoh kode berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP create_topic.
| Permintaan 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 }' |
Skema Input
Permintaan untuk membuat topik dalam kursus.
CreateTopicRequest
| Representasi JSON |
|---|
{ "courseId": string, "title": string } |
| Kolom | |
|---|---|
courseId |
Wajib. ID kursus. |
title |
Wajib. Judul topik. Maksimum 100 karakter. |
Skema Output
Topik dalam kursus.
Topik
| Representasi JSON |
|---|
{ "id": string, "title": string } |
| Kolom | |
|---|---|
id |
Hanya output. ID. ID Topik. |
title |
Judul topik. |
Anotasi Alat
Anotasi alat dikirim ke klien MCP untuk menjelaskan risiko dasar alat tertentu. Sebagian besar klien memperlakukan petunjuk ini sebagai tidak tepercaya, tetapi petunjuk tersebut dapat digunakan untuk memutuskan kapan perintah konfirmasi mungkin dikirim kepada pengguna.
Bersama dengan string judul, petunjuk boolean berikut ditentukan sebagai berikut:
readOnlyHint: Jika benar, alat tidak akan mengubah lingkungannya. Default: false.destructiveHint: Jika benar, alat dapat melakukan tindakan destruktif. Jika salah (false), alat hanya dapat melakukan tindakan aditif. Default: true.idempotentHint: Jika benar, memanggil alat berulang kali dengan argumen yang sama tidak akan memberikan efek tambahan pada lingkungannya. Default: false.openWorldHint: Jika benar, alat dapat berinteraksi dengan 'open world' entitas eksternal. Jika salah, alat hanya dapat berinteraksi dengan entity internal. Misalnya, alat penelusuran web akan bersifat open world, sedangkan alat memori tidak akan bersifat open world.
Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ❌ | Open World Hint: ❌
Cakupan Otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://www.googleapis.com/auth/classroom.topics