टूल: 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 |
ज़रूरी है. कोर्स का आइडेंटिफ़ायर. |
learningStandardIds[] |
ज़रूरी नहीं. इससे खोज के नतीजों में, सिर्फ़ इन स्टैंडर्ड सेट या कैटगरी के स्टैंडर्ड और उनसे जुड़े स्टैंडर्ड दिखते हैं. |
query |
ज़रूरी है. खोज के लिए इस्तेमाल हुए शब्द केस-इनसेंसिटिव होते हैं. नतीजों के कोड या स्टेटमेंट में, स्पेस से अलग किए गए सभी शब्द शामिल होने चाहिए. - जब |
includeGroupingStandards |
ज़रूरी नहीं. अगर यह वैल्यू true है, तो यह उन कैटगरी के हेडर दिखाता है जिनके आईडी, फ़ॉलो-अप खोजों को सीमित करते हैं. इन हेडर को कोर्सवर्क में टैग नहीं किया जा सकता. अगर यह वैल्यू false (डिफ़ॉल्ट) है, तो ऐसे स्टैंडर्ड दिखाए जाते हैं जिन्हें कोर्सवर्क में टैग किया जा सकता है. |
आउटपुट स्कीमा
जवाब में सीखने के स्टैंडर्ड शामिल हों.
SearchCourseStandardsResponse
| JSON के काेड में दिखाना |
|---|
{
"learningStandards": [
{
object ( |
| फ़ील्ड | |
|---|---|
learningStandards[] |
मिलते-जुलते लर्निंग स्टैंडर्ड की सूची. |
LearningGoal
| JSON के काेड में दिखाना |
|---|
{
"id": string,
"type": enum ( |
| फ़ील्ड | |
|---|---|
id |
सिर्फ़ आउटपुट के लिए. सीखने के लक्ष्य का आईडी. कोई स्टैंडर्ड अटैच करने के लिए, search_course_standards से |
type |
सिर्फ़ आउटपुट के लिए. सीखने के लक्ष्य का टाइप. |
standardCode |
सिर्फ़ आउटपुट के लिए. स्टैंडर्ड कोड (उदाहरण के लिए, "NY-2.NBT.4"). यह जानकारी सिर्फ़ स्टैंडर्ड के लिए अपने-आप भर जाती है. |
title |
सिर्फ़ आउटपुट के लिए. मानकों के लिए स्टेटमेंट का ब्यौरा या कौशल के लिए ऐसा टाइटल जिसे कोई भी व्यक्ति आसानी से पढ़ सके. |
documentTitle |
सिर्फ़ आउटपुट के लिए. पाठ्यक्रम के दस्तावेज़ का नाम. यह जानकारी सिर्फ़ स्टैंडर्ड के लिए अपने-आप भर जाती है. |
टाइप
सीखने के लक्ष्य का टाइप.
| 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.courseshttps://www.googleapis.com/auth/classroom.courses.readonly