MCP Tools Reference: classroommcp.googleapis.com

Alat: search_course_standards

Menelusuri standar pembelajaran akademik dalam kursus untuk diberi tag pada tugas mata pelajaran atau rubrik. Kursus harus memiliki standar pembelajaran yang dikonfigurasi oleh pengajar.

  • Standar spesifik: Telusuri dengan kode persis (misalnya, "HS-LS1-1") atau kata kunci spesifik (includeGroupingStandards=false).
  • Kategori: Tetapkan includeGroupingStandards=true dengan kata topik yang luas untuk menemukan kategori induk, lalu teruskan ID kategori ke learningStandardIds untuk mempersempit hasil.

Contoh kode berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP search_course_standards.

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": "search_course_standards",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Skema Input

Permintaan untuk menelusuri hierarki standar pembelajaran tingkat kursus yang telah dipilih sebelumnya.

SearchCourseStandardsRequest

Representasi JSON
{
  "courseId": string,
  "learningStandardIds": [
    string
  ],
  "query": string,
  "includeGroupingStandards": boolean
}
Kolom
courseId

string

Wajib. ID kursus.

learningStandardIds[]

string

Opsional. Membatasi penelusuran ke set standar atau standar kategori ini dan turunannya. Teruskan ID set standar dari Course.learning_goals (di list_courses) atau ID kategori dari panggilan sebelumnya dengan includeGroupingStandards = true (bukan standardCode), bukan keduanya. Jika kosong, semua standar dalam kursus akan ditelusuri.

query

string

Wajib. Istilah penelusuran tidak peka huruf besar/kecil; hasil harus berisi SEMUA kata yang dipisahkan spasi dalam kode atau pernyataannya. - Jika includeGroupingStandards = false: teruskan kode standar yang tepat (misalnya, "HS-LS1-1") atau 2-3 kata kunci spesifik (misalnya, "luas segitiga"). - Jika includeGroupingStandards = true: teruskan 1-2 kata domain luas (misalnya, "geometri") yang cocok dengan judul kategori.

includeGroupingStandards

boolean

Opsional. Jika benar, akan menampilkan header kategori (tidak dapat diberi tag ke tugas mata pelajaran) yang ID-nya mempersempit penelusuran lanjutan. Jika salah (default), menampilkan standar yang dapat diberi tag pada tugas mata pelajaran.

Skema Output

Respons yang berisi standar pembelajaran.

SearchCourseStandardsResponse

Representasi JSON
{
  "learningStandards": [
    {
      object (LearningGoal)
    }
  ]
}
Kolom
learningStandards[]

object (LearningGoal)

Daftar standar yang cocok.

LearningGoal

Representasi JSON
{
  "id": string,
  "type": enum (Type),
  "standardCode": string,
  "title": string,
  "documentTitle": string
}
Kolom
id

string

Hanya output. ID sasaran pembelajaran. Untuk melampirkan standar, gunakan id dari search_course_standards (bukan standardCode).

type

enum (Type)

Hanya output. Jenis sasaran pembelajaran.

standardCode

string

Hanya output. Kode standar (misalnya, "NY-2.NBT.4"). Hanya diisi untuk standar.

title

string

Hanya output. Deskripsi pernyataan untuk standar, atau judul yang dapat dibaca manusia untuk keterampilan.

documentTitle

string

Hanya output. Nama dokumen kurikulum. Hanya diisi untuk standar.

Jenis

Jenis sasaran pembelajaran.

Enum
TYPE_UNSPECIFIED Jenis sasaran pembelajaran belum ditentukan.
STANDARD Standar pembelajaran dari kurikulum akademik.
SKILL Keterampilan yang mewakili konsep atau kompetensi pendidikan. Hanya pengajar yang dapat menambahkan atau menghapus keterampilan di Classroom.

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.courses
  • https://www.googleapis.com/auth/classroom.courses.readonly