MCP Tools Reference: classroommcp.googleapis.com

টুল: search_course_standards

কোর্সওয়ার্ক বা রুবিকে ট্যাগ করার জন্য কোর্সে একাডেমিক লার্নিং স্ট্যান্ডার্ড সার্চ করে। কোর্সে শিক্ষকের দ্বারা কনফিগার করা লার্নিং স্ট্যান্ডার্ড থাকতে হবে।

  • নির্দিষ্ট স্ট্যান্ডার্ড: সঠিক কোড (যেমন, "HS-LS1-1") বা নির্দিষ্ট কীওয়ার্ড (includeGroupingStandards=false) দিয়ে সার্চ করুন।
  • বিভাগ: পেরেন্ট বিভাগ খুঁজে পেতে, একটি বিস্তৃত বিষয়ের শব্দের সাথে includeGroupingStandards=true সেট করুন, তারপর ফলাফল আরও নির্দিষ্ট করতে learningStandardIds-এ বিভাগ আইডি পাস করুন।

নিচের কোড স্যাম্পেল থেকে বোঝা যায় যে search_course_standards MCP টুল কল করার জন্য কীভাবে curl ব্যবহার করতে হয়।

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
}'

ইনপুট স্কিমা

আগে থেকে বেছে নেওয়া কোর্স-লেভেল লার্নিং স্ট্যান্ডার্ড ট্রিতে সার্চ করার অনুরোধ।

SearchCourseStandardsRequest

JSON উপস্থাপনা
{
  "courseId": string,
  "learningStandardIds": [
    string
  ],
  "query": string,
  "includeGroupingStandards": boolean
}
ফিল্ড
courseId

string

প্রয়োজনীয়। কোর্সের শনাক্তকারী।

learningStandardIds[]

string

ঐচ্ছিক। এইসব স্ট্যান্ডার্ড সেট বা বিভাগের স্ট্যান্ডার্ড এবং তাদের ডিসেন্ড্যান্টে সার্চ সীমাবদ্ধ করে। Course.learning_goals (list_courses-এ) থেকে স্ট্যান্ডার্ড সেট আইডি অথবা includeGroupingStandards = true (standardCode নয়) সহ আগের কল থেকে ক্যাটেগরি আইডি পাস করুন, দুটিই নয়। খালি থাকলে, কোর্সের সব স্ট্যান্ডার্ড সার্চ করে।

query

string

প্রয়োজনীয়। সার্চ করা শব্দে ছোট বা বড় হাতের অক্ষর ব্যবহার করা যেতে পারে; ফলাফলের কোড বা বিবৃতিতে স্পেস দিয়ে আলাদা করা প্রতিটি শব্দ থাকতে হবে। - includeGroupingStandards = false হলে: একটি সঠিক স্ট্যান্ডার্ড কোড (যেমন, "HS-LS1-1") বা ২-৩টি নির্দিষ্ট কীওয়ার্ড (যেমন, "area triangles") পাস করুন। - includeGroupingStandards = true হলে: ক্যাটেগরি টাইটেলের সাথে ম্যাচ করে এমন ১-২টি ব্রড ডোমেন শব্দ (যেমন, "জ্যামিতি") পাস করুন।

includeGroupingStandards

boolean

ঐচ্ছিক। ট্রু হলে, ক্যাটেগরি হেডার (কোর্সওয়ার্কে ট্যাগ করা যায় না) রিটার্ন করে, যার আইডি ফলো-আপ সার্চকে সীমিত করে। মিথ্যা (ডিফল্ট) হলে, কোর্সওয়ার্কে ট্যাগ করা যেতে পারে এমন স্ট্যান্ডার্ড ফিরিয়ে দেয়।

আউটপুট স্কিমা

লার্নিং স্ট্যান্ডার্ড সহ উত্তর।

SearchCourseStandardsResponse

JSON উপস্থাপনা
{
  "learningStandards": [
    {
      object (LearningGoal)
    }
  ]
}
ফিল্ড
learningStandards[]

object (LearningGoal)

ম্যাচিং স্ট্যান্ডার্ডের তালিকা।

LearningGoal

JSON উপস্থাপনা
{
  "id": string,
  "type": enum (Type),
  "standardCode": string,
  "title": string,
  "documentTitle": string
}
ফিল্ড
id

string

শুধু আউটপুট। লার্নিং সংক্রান্ত লক্ষ্যের আইডি। স্ট্যান্ডার্ড অ্যাটাচ করতে, search_course_standards থেকে id ব্যবহার করুন (standardCode নয়)।

type

enum (Type)

শুধু আউটপুট। লার্নিং সংক্রান্ত লক্ষ্যের ধরন।

standardCode

string

শুধু আউটপুট। স্ট্যান্ডার্ড কোড (যেমন, "NY-2.NBT.4")। শুধুমাত্র স্ট্যান্ডার্ডের জন্য পূরণ করা হয়েছে।

title

string

শুধু আউটপুট। স্ট্যান্ডার্ডের জন্য স্টেটমেন্টের বিবরণ অথবা দক্ষতার জন্য মানুষের-পঠনযোগ্য শীর্ষক।

documentTitle

string

শুধু আউটপুট। কারিকুলাম ডকুমেন্টের নাম। শুধুমাত্র স্ট্যান্ডার্ডের জন্য পূরণ করা হয়েছে।

ধরন

লার্নিং সংক্রান্ত লক্ষ্যের ধরন।

Enums
TYPE_UNSPECIFIED শেখার লক্ষ্যের ধরন নির্দিষ্ট করা নেই।
STANDARD অ্যাকাডেমিক পাঠ্যক্রম থেকে লার্নিং স্ট্যান্ডার্ড।
SKILL শিক্ষামূলক ধারণা বা দক্ষতা উপস্থাপন করে এমন স্কিল। Classroom-এ শুধু শিক্ষকই স্কিল যোগ করতে বা সরাতে পারবেন।

টুল অ্যানোটেশন

প্রদত্ত টুলের প্রাথমিক ঝুঁকি বর্ণনা করার জন্য MCP ক্লায়েন্টদের টুল অ্যানোটেশন পাঠানো হয়। বেশিরভাগ ক্লায়েন্ট এইসব ইঙ্গিতকে বিশ্বাসযোগ্য বলে মনে করে না, তবে ব্যবহারকারীকে কখন কনফার্মেশন প্রম্পট পাঠানো হবে তা নির্ধারণ করতে এগুলি ব্যবহার করা যেতে পারে।

টাইটেল স্ট্রিংয়ের সাথে, নিম্নলিখিত বুলিয়ান ইঙ্গিতগুলি এইভাবে সংজ্ঞায়িত করা হয়েছে:

  • readOnlyHint: সত্য হলে, টুলটি তার পরিবেশ পরিবর্তন করে না। ডিফল্ট: false.
  • destructiveHint: সত্য হলে, টুলটি ধ্বংসাত্মক অ্যাকশন পারফর্ম করতে পারে। মিথ্যা হলে, টুলটি শুধুমাত্র যোগ করার অ্যাকশন করতে পারে। ডিফল্ট: true.
  • idempotentHint: সত্য হলে, একই আর্গুমেন্ট সহ টুলটিকে বারবার কল করলে এর এনভায়রনমেন্টে কোনও অতিরিক্ত প্রভাব পড়বে না। ডিফল্ট: false.
  • openWorldHint: সত্য হলে, টুলটি বাহ্যিক এন্টিটির 'মুক্ত পৃথিবী'-র সাথে ইন্টার‍্যাক্ট করতে পারে। মিথ্যা হলে, টুলটি শুধুমাত্র অভ্যন্তরীণ এন্টিটির সাথে ইন্টার‍্যাক্ট করতে পারে। যেমন, ওয়েব সার্চ টুল ওপেন ওয়ার্ল্ড হলেও মেমরি টুল ওপেন ওয়ার্ল্ড নয়।

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌

অনুমোদনের স্কোপ

নিম্নলিখিত OAuth স্কোপগুলির মধ্যে একটি প্রয়োজন:

  • https://www.googleapis.com/auth/classroom.courses
  • https://www.googleapis.com/auth/classroom.courses.readonly