টুল: 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 ( |
| ফিল্ড | |
|---|---|
courseState |
ঐচ্ছিক। কোর্সের স্ট্যাটাস অনুযায়ী ফিল্টার করুন। ডিফল্ট হিসেবে |
createdDateRange |
ঐচ্ছিক। তৈরি করার তারিখের রেঞ্জ অনুযায়ী ফিল্টার করুন। |
timeZone |
প্রয়োজনীয়। ব্যবহারকারীর IANA টাইমজোন (যেমন |
titleContains |
ঐচ্ছিক। কেস-ইনসেনসিটিভ সাবস্ট্রিং অনুযায়ী শীর্ষক ফিল্টার করুন। |
pageSize |
ঐচ্ছিক। পৃষ্ঠার সাইজ কন্ট্রোল করে। ডিফল্ট ১০; সর্বাধিক ৫০। |
pageToken |
ঐচ্ছিক। পৃষ্ঠার ক্রমসংখ্যার জন্য টোকেন। |
DateRange
| JSON উপস্থাপনা |
|---|
{ "startDate": string, "endDate": string } |
| ফিল্ড | |
|---|---|
startDate |
রেঞ্জের ইনক্লুসিভ শুরু (ফর্ম্যাট: YYYY-MM-DD)। |
endDate |
রেঞ্জের অন্তর্ভুক্ত শেষ তারিখ (ফর্ম্যাট: YYYY-MM-DD)। |
রাজ্য
কোর্সের স্ট্যাটাস।
| Enums | |
|---|---|
STATE_UNSPECIFIED |
অনির্দিষ্ট স্ট্যাটাস। |
ACTIVE |
অ্যাক্টিভ স্ট্যাটাস। |
ARCHIVED |
আর্কাইভ করা স্ট্যাটাস। |
PROVISIONED |
প্রভিশন করা স্ট্যাটাস। |
আউটপুট স্কিমা
কোর্সের তালিকা দেখানোর জন্য রেসপন্স।
ListCoursesResponse
| JSON উপস্থাপনা |
|---|
{
"courses": [
{
object ( |
| ফিল্ড | |
|---|---|
courses[] |
কোর্সের তালিকা। |
nextPageToken |
পরবর্তী পৃষ্ঠার টোকেন। |
কোর্স
| JSON উপস্থাপনা |
|---|
{ "id": string, "title": string, "role": enum ( |
| ফিল্ড | |
|---|---|
id |
শনাক্তকারী। এই কোর্সের শনাক্তকারী। |
title |
কোর্সের নাম। |
role |
এই কোর্সে ব্যবহারকারীর ভূমিকা। |
creationDate |
কোর্স তৈরির তারিখ (ফর্ম্যাট: YYYY-MM-DD)। তৈরির তারিখ জানা না থাকলে ফাঁকা রাখুন। |
state |
শুধু আউটপুট। কোর্সের স্ট্যাটাস। |
section |
ঐচ্ছিক। কোর্সের বিভাগ। |
room |
ঐচ্ছিক। কোর্সের রুম। |
subject |
ঐচ্ছিক। কোর্সের বিষয়। |
gradeLevels |
ঐচ্ছিক। কোর্সের গ্রেড লেভেল। |
description |
ঐচ্ছিক। কোর্সের বিবরণ। |
learningGoals[] |
শুধু আউটপুট। এই কোর্সের সাথে শেখার লক্ষ্য অ্যাটাচ করা আছে। |
LearningGoal
| JSON উপস্থাপনা |
|---|
{
"id": string,
"type": enum ( |
| ফিল্ড | |
|---|---|
id |
শুধু আউটপুট। লার্নিং সংক্রান্ত লক্ষ্যের আইডি। স্ট্যান্ডার্ড অ্যাটাচ করতে, search_course_standards থেকে |
type |
শুধু আউটপুট। লার্নিং সংক্রান্ত লক্ষ্যের ধরন। |
standardCode |
শুধু আউটপুট। স্ট্যান্ডার্ড কোড (যেমন, "NY-2.NBT.4")। শুধুমাত্র স্ট্যান্ডার্ডের জন্য পূরণ করা হয়েছে। |
title |
শুধু আউটপুট। স্ট্যান্ডার্ডের জন্য স্টেটমেন্টের বিবরণ অথবা দক্ষতার জন্য মানুষের-পঠনযোগ্য শীর্ষক। |
documentTitle |
শুধু আউটপুট। কারিকুলাম ডকুমেন্টের নাম। শুধুমাত্র স্ট্যান্ডার্ডের জন্য পূরণ করা হয়েছে। |
ভূমিকা
কোনও কোর্সে ব্যবহারকারীর ভূমিকা।
| 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.readonlyhttps://www.googleapis.com/auth/classroom.rosters.readonly