MCP Tools Reference: classroommcp.googleapis.com

টুল: list_courses

ব্যবহারকারীর কোর্সগুলি তাদের বিবরণ সহ তালিকাভুক্ত করে (বিভাগ, রুম, বিষয়, গ্রেড লেভেল, বিবরণ, শেখার লক্ষ্য, অবস্থা এবং ব্যবহারকারীর ভূমিকা)। কোর্স খুঁজে পেতে এবং তাদের আইডি ফিরিয়ে আনতে প্রাথমিক এন্ট্রি পয়েন্ট হিসেবে এটি ব্যবহার করুন। কোর্সের নাম প্রায়ই একই হয়, তাই আলাদা করে বোঝাতে বিভাগ ব্যবহার করুন। courseState সেট করা না থাকলে (যেমন, ARCHIVED) শুধুমাত্র ACTIVE কোর্স দেখায়।

Classroom ওয়েব অ্যাপে কোনও কোর্সের সাথে ব্যবহারকারীকে লিঙ্ক করতে, https://classroom.google.com/c/{course_id} (স্ট্রিম) অথবা https://classroom.google.com/w/{course_id}/t/all (ক্লাসওয়ার্ক পৃষ্ঠা) ব্যবহার করুন। আইডি যেভাবে ফেরত দেওয়া হয়েছে ঠিক সেভাবেই ব্যবহার করুন; কখনও অনুমান বা পরিবর্তন করবেন না।

নিচের কোড স্যাম্পেল থেকে বোঝা যায় যে list_courses 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": "list_courses",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

ইনপুট স্কিমা

কোর্সের তালিকা দেখানোর অনুরোধ।

ListCoursesRequest

JSON উপস্থাপনা
{
  "courseState": enum (State),
  "createdDateRange": {
    object (DateRange)
  },
  "timeZone": string,
  "titleContains": string,
  "pageSize": integer,
  "pageToken": string
}
ফিল্ড
courseState

enum (State)

ঐচ্ছিক। কোর্সের স্ট্যাটাস অনুযায়ী ফিল্টার করুন। ডিফল্ট হিসেবে ACTIVE সেট করা থাকে।

createdDateRange

object (DateRange)

ঐচ্ছিক। তৈরি করার তারিখের রেঞ্জ অনুযায়ী ফিল্টার করুন।

timeZone

string

প্রয়োজনীয়। ব্যবহারকারীর IANA টাইমজোন (যেমন "America/Los_Angeles")। এই অনুরোধে তারিখগুলি এতে ব্যাখ্যা করা হয়েছে এবং প্রতিক্রিয়াতে তারিখগুলি এতে ফর্ম্যাট করা হয়েছে, যা ব্যবহারকারী Classroom-এ যা দেখেন তার সাথে মেলে।

titleContains

string

ঐচ্ছিক। কেস-ইনসেনসিটিভ সাবস্ট্রিং অনুযায়ী শীর্ষক ফিল্টার করুন।

pageSize

integer

ঐচ্ছিক। পৃষ্ঠার সাইজ কন্ট্রোল করে। ডিফল্ট ১০; সর্বাধিক ৫০।

pageToken

string

ঐচ্ছিক। পৃষ্ঠার ক্রমসংখ্যার জন্য টোকেন।

DateRange

JSON উপস্থাপনা
{
  "startDate": string,
  "endDate": string
}
ফিল্ড
startDate

string

রেঞ্জের ইনক্লুসিভ শুরু (ফর্ম্যাট: YYYY-MM-DD)।

endDate

string

রেঞ্জের অন্তর্ভুক্ত শেষ তারিখ (ফর্ম্যাট: YYYY-MM-DD)।

রাজ্য

কোর্সের স্ট্যাটাস।

Enums
STATE_UNSPECIFIED অনির্দিষ্ট স্ট্যাটাস।
ACTIVE অ্যাক্টিভ স্ট্যাটাস।
ARCHIVED আর্কাইভ করা স্ট্যাটাস।
PROVISIONED প্রভিশন করা স্ট্যাটাস।

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

কোর্সের তালিকা দেখানোর জন্য রেসপন্স।

ListCoursesResponse

JSON উপস্থাপনা
{
  "courses": [
    {
      object (Course)
    }
  ],
  "nextPageToken": string
}
ফিল্ড
courses[]

object (Course)

কোর্সের তালিকা।

nextPageToken

string

পরবর্তী পৃষ্ঠার টোকেন।

কোর্স

JSON উপস্থাপনা
{
  "id": string,
  "title": string,
  "role": enum (Role),
  "creationDate": string,
  "state": enum (State),
  "section": string,
  "room": string,
  "subject": string,
  "gradeLevels": string,
  "description": string,
  "learningGoals": [
    {
      object (LearningGoal)
    }
  ]
}
ফিল্ড
id

string

শনাক্তকারী। এই কোর্সের শনাক্তকারী।

title

string

কোর্সের নাম।

role

enum (Role)

এই কোর্সে ব্যবহারকারীর ভূমিকা।

creationDate

string

কোর্স তৈরির তারিখ (ফর্ম্যাট: YYYY-MM-DD)। তৈরির তারিখ জানা না থাকলে ফাঁকা রাখুন।

state

enum (State)

শুধু আউটপুট। কোর্সের স্ট্যাটাস।

section

string

ঐচ্ছিক। কোর্সের বিভাগ।

room

string

ঐচ্ছিক। কোর্সের রুম।

subject

string

ঐচ্ছিক। কোর্সের বিষয়।

gradeLevels

string

ঐচ্ছিক। কোর্সের গ্রেড লেভেল।

description

string

ঐচ্ছিক। কোর্সের বিবরণ।

learningGoals[]

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
ROLE_UNSPECIFIED অনির্দিষ্ট ভূমিকা।
TEACHER শিক্ষকের ভূমিকা।
COTEACHER সহ-শিক্ষকের ভূমিকা।
STUDENT স্টুডেন্টের ভূমিকা।
INVITED_OR_INACTIVE আমন্ত্রিত বা নিষ্ক্রিয় ভূমিকা।

রাজ্য

কোর্সের স্ট্যাটাস।

Enums
STATE_UNSPECIFIED অনির্দিষ্ট স্ট্যাটাস।
ACTIVE অ্যাক্টিভ স্ট্যাটাস।
ARCHIVED আর্কাইভ করা স্ট্যাটাস।
PROVISIONED প্রভিশন করা স্ট্যাটাস।

ধরন

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

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