MCP Tools Reference: classroommcp.googleapis.com

टूल: search_course_standards

यह कोर्सवर्क या रूब्रिक में टैग करने के लिए, किसी कोर्स में सीखने के एकेडमिक स्टैंडर्ड खोजता है. इसके लिए, कोर्स में सीखने के स्टैंडर्ड कॉन्फ़िगर किए गए हों. ये स्टैंडर्ड, शिक्षक कॉन्फ़िगर करता है.

  • खास स्टैंडर्ड: सटीक कोड (जैसे, "HS-LS1-1") या खास कीवर्ड (includeGroupingStandards=false) का इस्तेमाल करके खोजें.
  • कैटगरी: पैरंट कैटगरी ढूंढने के लिए, किसी विषय के ब्रॉड कीवर्ड के साथ includeGroupingStandards=true सेट करें. इसके बाद, नतीजों को सटीक बनाने के लिए, कैटगरी आईडी को learningStandardIds में पास करें.

यहां दिए गए कोड सैंपल में, search_course_standards एमसीपी टूल को कॉल करने के लिए 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

ज़रूरी नहीं. अगर यह वैल्यू true है, तो यह उन कैटगरी के हेडर दिखाता है जिनके आईडी, फ़ॉलो-अप खोजों को सीमित करते हैं. इन हेडर को कोर्सवर्क में टैग नहीं किया जा सकता. अगर यह वैल्यू false (डिफ़ॉल्ट) है, तो ऐसे स्टैंडर्ड दिखाए जाते हैं जिन्हें कोर्सवर्क में टैग किया जा सकता है.

आउटपुट स्कीमा

जवाब में सीखने के स्टैंडर्ड शामिल हों.

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 में सिर्फ़ शिक्षक ही स्किल जोड़ या हटा सकता है.

टूल एनोटेशन

टूल के एनोटेशन, एमसीपी क्लाइंट को भेजे जाते हैं. इससे उन्हें किसी टूल से जुड़े बुनियादी जोखिम के बारे में जानकारी मिलती है. ज़्यादातर क्लाइंट इन संकेतों को भरोसेमंद नहीं मानते. हालांकि, इनका इस्तेमाल यह तय करने के लिए किया जा सकता है कि उपयोगकर्ता को पुष्टि करने का अनुरोध कब भेजा जाए.

टाइटल स्ट्रिंग के साथ-साथ, बूलियन हिंट के बारे में यहां बताया गया है:

  • readOnlyHint: अगर इसकी वैल्यू true है, तो टूल अपने एनवायरमेंट में बदलाव नहीं करता. डिफ़ॉल्ट: false.
  • destructiveHint: अगर इसकी वैल्यू true है, तो टूल नुकसान पहुंचाने वाली कार्रवाइयां कर सकता है. अगर यह वैल्यू false पर सेट है, तो टूल सिर्फ़ जोड़ने वाली कार्रवाइयां कर सकता है. डिफ़ॉल्ट: true.
  • idempotentHint: अगर इसकी वैल्यू true है, तो टूल को एक ही आर्ग्युमेंट के साथ बार-बार कॉल करने पर, उसके एनवायरमेंट पर कोई और असर नहीं पड़ेगा. डिफ़ॉल्ट: false.
  • openWorldHint: सही होने पर, टूल बाहरी इकाइयों की 'विशाल दुनिया' के साथ इंटरैक्ट कर सकता है. अगर यह वैल्यू false पर सेट है, तो टूल सिर्फ़ इंटरनल इकाइयों के साथ इंटरैक्ट कर सकता है. उदाहरण के लिए, वेब सर्च टूल ओपन वर्ल्ड होगा, जबकि मेमोरी टूल ओपन वर्ल्ड नहीं होगा.

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