उपयोगकर्ता, Google Classroom में कोर्स और असाइनमेंट के लिए, सीखने के लक्ष्य सेट कर सकते हैं.
सीखने के ये लक्ष्य, Classroom API में भी दिखते हैं. आप
सीखने के स्टैंडर्ड से जुड़े सेट को Course
संसाधनों पर और सीखने के लक्ष्य को CourseWork और
Rubric संसाधनों पर सेट कर सकते हैं, वापस पा सकते हैं और उनमें बदलाव कर सकते हैं. इस गाइड में, Classroom API का इस्तेमाल करके, सीखने के लक्ष्यों और स्टैंडर्ड सेट को ऐक्सेस करने और उनमें बदलाव करने का तरीका बताया गया है.
Course
संसाधनों पर सीखने के स्टैंडर्ड से जुड़े सेट के लिए, एपीआई की सुविधा अब उपलब्ध है. CourseWork और Rubric संसाधनों पर सीखने के लक्ष्यों के लिए, एपीआई की सुविधा 2026 की तीसरी तिमाही में उपलब्ध होगी.
यह कैसे काम करता है
डेटा सोर्स
Classroom में सीखने के लक्ष्य, Satchel Rosetta Exchange (पहले CASE Network) की ओर से उपलब्ध कराए गए, दुनिया भर में यूनीक और स्थिर आइडेंटिफ़ायर (जीयूआईडी) पर निर्भर करते हैं. Exchange में मौजूद स्टैंडर्ड, नोड के ट्री में व्यवस्थित होते हैं. इनमें रूट, किसी खास विषय के लिए, स्टैंडर्ड का एक पूरा सेट होता है. वहीं, चाइल्ड नोड, सीखने के ज़्यादा खास नतीजों के बारे में बताते हैं. नेटवर्क में, स्टैंडर्ड कोड या लीफ़ नोड वाले किसी भी नोड के आइडेंटिफ़ायर को
CourseWork पर सीखने के लक्ष्य के तौर पर सेट किया जा सकता है. वहीं, किसी भी नॉन-लीफ़ नोड को
Course पर सीखने के स्टैंडर्ड से जुड़े सेट के तौर पर सेट किया जा सकता है.
Courseसंसाधन के लिए, सीखने के स्टैंडर्ड से जुड़े सेट, स्टैंडर्ड के उस ग्रुप को दिखाते हैं जो शिक्षकों के सीखने के लक्ष्यों को टैग करने पर, Classroom के यूज़र इंटरफ़ेस (यूआई) में दिखते हैं.CourseWork,CourseWorkMaterialयाRubricसंसाधन से जुड़े सीखने के लक्ष्य, उस असाइनमेंट, सवाल, मटीरियल या रूब्रिक के खास मानदंड से जुड़े स्टैंडर्ड या स्किल को दिखाते हैं.
Google, Satchel Rosetta Exchange से पांच तरह की जानकारी का इस्तेमाल करता है:
- दस्तावेज़ आईडी: रूट-लेवल नोड के लिए जीयूआईडी. यह आईडी, टॉप-लेवल स्टैंडर्ड कंटेनर से मेल खाता है और यह सभी चाइल्ड नोड के लिए एक जैसा होता है.
- दस्तावेज़ का शीर्षक: स्टैंडर्ड के पूरे दस्तावेज़ का ऐसा नाम जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है.
- आइटम आईडी: किसी एक स्टैंडर्ड (यानी, नॉन-रूट नोड) के लिए जीयूआईडी.
- स्टैंडर्ड का शीर्षक: किसी एक स्टैंडर्ड का ऐसा ब्यौरा जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है.
- स्टैंडर्ड कोड: किसी खास स्टैंडर्ड के लिए, ऐसा संक्षिप्त नाम जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है.
स्टैंडर्ड और लक्ष्यों के लिए वैल्यू ढूंढना
यह समझने के लिए कि ये वैल्यू कहां मिलेंगी, न्यूयॉर्क स्टेट के गणित के स्टैंडर्ड का एक उदाहरण देखें. रूट नोड से शुरू करें:
पहली इमेज: Satchel Rosetta Exchange में चुने जाने पर, रूट नोड का व्यू. इसमें दस्तावेज़ का शीर्षक और दस्तावेज़ आईडी दिखता है. ये दोनों इस पेज पर मौजूद सभी नोड के लिए एक जैसे होते हैं.
पहली इमेज में मौजूद व्यू से, ये वैल्यू निकाली जा सकती हैं:
- दस्तावेज़ आईडी:
c649d172-d7cb-11e8-824f-0242ac160002 - दस्तावेज़ का शीर्षक:
New York State Next Generation Mathematics Learning Standards
किसी एक स्टैंडर्ड की वैल्यू पाने के लिए, किसी स्टैंडर्ड पर क्लिक करें और उसका मेटाडेटा बड़ा करें:
दूसरी इमेज: Satchel Rosetta
Exchange में चुने जाने पर, नॉन-रूट नोड के मेटाडेटा का व्यू. इसमें आइटम आईडी, स्टैंडर्ड कोड, और स्टैंडर्ड का शीर्षक दिखता है. ये वैल्यू सिर्फ़ इस स्टैंडर्ड के लिए होती हैं.
दूसरी इमेज में मौजूद व्यू से, ये वैल्यू पाई जा सकती हैं:
- आइटम आईडी:
70d64c79-d7cc-11e8-824f-0242ac160002 - स्टैंडर्ड का शीर्षक:
Understand that the digits of a three-digit number represent amounts of hundreds, tens, and ones. - स्टैंडर्ड कोड:
NY-2.NBT.4
ध्यान दें कि दस्तावेज़ और आइटम आईडी, हर नोड के Satchel Rosetta Exchange के यूआरएल से भी निकाले जा सकते हैं. ये यूआरएल, https://rosetta.commongoodlt.com/{document_id}/{item_id} पैटर्न में होते हैं.
लिंक किए जा सकने वाले आइटम की ज़्यादा से ज़्यादा संख्या
- हर
Courseमें, सीखने के स्टैंडर्ड से जुड़े ज़्यादा से ज़्यादा पांच सेट हो सकते हैं. - हर
CourseWorkमें, सीखने के ज़्यादा से ज़्यादा 10 लक्ष्य हो सकते हैं. - रूब्रिक के हर
Criterionमें, सीखने का एक लक्ष्य हो सकता है.
कोर्स के लिए, सीखने के स्टैंडर्ड से जुड़े सेट मैनेज करना
सीखने के स्टैंडर्ड से जुड़े सेट में बदलाव करना
सीखने के स्टैंडर्ड से जुड़े सेट में बदलाव करने के लिए, Course.learningStandardSettings फ़ील्ड में standardSets ऑब्जेक्ट भरें.Course हर standardSet में, caseGuid ऑब्जेक्ट होना चाहिए. इसमें caseDocumentId और ज़रूरत पड़ने पर caseItemId शामिल होता है.
सीखने के स्टैंडर्ड से जुड़े सेट, किसी भी Course बदलाव के अनुरोध का इस्तेमाल करके जोड़े जा सकते हैं. जैसे,
courses.create() या courses.patch() के साथ
learningStandardSettings अपडेट मास्क.
यहां दिए गए उदाहरण में, किसी मौजूदा कोर्स के लिए, स्टैंडर्ड के दो सेट सेट किए गए हैं.
Python
service = build("classroom", "v1", credentials=creds)
course = {
"learning_standard_settings": {
# Each Course can have up to 5 learning standard sets.
"standard_sets": [
# Construct a GUID for the NYS Next Gen Math Standards top-level node.
# This is a top-level non-leaf node, so it only has a Document ID.
{
"case_guid": {
"case_document_id": "c649d172-d7cb-11e8-824f-0242ac160002"
}
},
# Construct a GUID for the AAS ELA21.AAS.K Standard node.
# This is a mid-level non-leaf node, so it has both Document and Item IDs.
{
"case_guid": {
"case_document_id": "bfc264b3-b4d1-4780-84ff-26b12e6945a6",
"case_item_id": "ada2cc30-7d6d-494e-8c6b-c998bae98f0b",
}
},
]
}
}
course = (
service.courses()
.patch(
id=course_id,
updateMask="learningStandardSettings",
body=course,
# Specify the preview version while the feature is in Developer Preview.
# Learning standards and goals are supported in V1_20260316_PREVIEW and
# later.
previewVersion="V1_20260316_PREVIEW")
.execute()
)
print(f"Course updated: {course.get('name')}")
सीखने के स्टैंडर्ड से जुड़े सेट वापस पाना
किसी कोर्स के लिए, सीखने के मौजूदा स्टैंडर्ड से जुड़े सेट देखने के लिए, Course.learningStandardSettings फ़ील्ड की जांच करें. इस फ़ील्ड में, standardSets ऑब्जेक्ट की सीरीज़ होती है. अगर कोर्स में, सीखने के स्टैंडर्ड से जुड़े सेट मौजूद नहीं हैं, तो यह फ़ील्ड खाली हो सकता है.
ध्यान दें कि जवाब में मौजूद हर standardSet में, स्टैंडर्ड का ब्यौरा और उसके रूट दस्तावेज़ का शीर्षक शामिल होता है. ये टेक्स्ट, Classroom के यूज़र इंटरफ़ेस (यूआई) में शिक्षकों और छात्र-छात्राओं के लिए भी दिखते हैं. आपको sourceDataAvailabilityStatus भी मिलता है. इससे पता चलता है कि Satchel Rosetta Exchange में स्टैंडर्ड उपलब्ध है या नहीं.
{
"id": "123456789",
"name": "LSS test class",
"learning_standard_settings": {
"standard_sets": [{
"case_guid": {
"case_document_id": "c649d172-d7cb-11e8-824f-0242ac160002"
},
"document_title": "New York State Next Generation Mathematics Learning Standards",
"source_data_availability_status": "LEARNING_STANDARD_AVAILABLE"
},
{
"case_guid": {
"case_document_id": "bfc264b3-b4d1-4780-84ff-26b12e6945a6",
"case_item_id": "d52217c0-1c5b-4d92-9664-d0792944f3fe"
},
"document_title": "AAS English Language Arts (2021)",
"standard_title": "With prompting and support, actively listen and speak.",
"source_data_availability_status": "LEARNING_STANDARD_AVAILABLE"
}]
}
}
CourseWork और रूब्रिक के लिए, सीखने के लक्ष्य मैनेज करना
सीखने के लक्ष्यों में बदलाव करना
बदलाव करने के किसी भी अनुरोध में, CourseWork,
CourseWorkMaterial, और रूब्रिक के Criterion
संसाधनों में, सीखने के लक्ष्य जोड़े जा सकते हैं. CourseWork.learningGoals या Rubric.Criterion.learningGoal फ़ील्ड में, दस्तावेज़ और आइटम आइडेंटिफ़ायर सेट करें. ये वही आइडेंटिफ़ायर हैं जिनके बारे में पहले बताया गया है.
ध्यान दें कि रूब्रिक के मानदंडों से जुड़े सीखने के लक्ष्य, उस असाइनमेंट से पहले ही जुड़े होने चाहिए जिससे Rubric लिंक है.Rubric
यहां दिए गए उदाहरण में, CourseWork असाइनमेंट बनाया गया है. इसमें सीखने के दो लक्ष्य जोड़े गए हैं.
Python
# Create a CourseWork assignment with two attached learning goals.
service = build("classroom", "v1", credentials=creds)
coursework = {
"title": "Ant colonies",
"description": "Read the article about ant colonies and complete the quiz.",
"materials": [
{"link": {"url": "http://example.com/ant-colonies"}},
{"link": {"url": "http://example.com/ant-quiz"}},
],
"workType": "ASSIGNMENT",
"state": "PUBLISHED",
# Each CourseWork can have up to 10 learning goals.
"learning_goals": [
{
"learning_standard_info": {
# Construct a GUID for the ELA21.AAS.11.11c Standard node.
# This is a non-root node, so it has both Document and Item IDs.
"case_guid": {
"case_document_id": "bfc264b3-b4d1-4780-84ff-26b12e6945a6",
"case_item_id": "6d922f1f-b580-42a1-b6d2-5ee5b39c561d",
}
}
},
{
"learning_standard_info": {
# Construct a GUID for the ELA21.AAS.11.22a Standard node.
# This is a non-root node, so it has both Document and Item IDs.
"case_guid": {
"case_document_id": "bfc264b3-b4d1-4780-84ff-26b12e6945a6",
"case_item_id": "a684609a-c3ec-42da-8b7f-7a325b31ea4a",
}
}
},
],
}
coursework = (
service.courses()
.courseWork()
.create(
courseId=course_id,
body=coursework,
# Specify the preview version while the feature is in Developer Preview.
# Learning standards and goals are supported in V1_20260316_PREVIEW and
# later.
previewVersion="V1_20260316_PREVIEW")
.execute()
)
print(f"Assignment created with ID {coursework.get('id')}")
यहां दिए गए उदाहरण में, Rubric बनाया गया है. इसमें हर मानदंड से, सीखने का एक लक्ष्य जोड़ा गया है.
Python
# Create a new Rubric with a learning goal attached to each criterion.
service = build("classroom", "v1", credentials=creds)
body = {
"criteria": [
{
"title": "Argument",
"description": "How well structured your argument is.",
"levels": [
{
"title": "Convincing",
"description": "A compelling case is made.",
"points": 30,
},
{
"title": "Passable",
"description": "Missing some evidence.",
"points": 20,
},
{
"title": "Needs Work",
"description": "Not enough strong evidence.",
"points": 0,
},
],
# Each Criterion can have one learning goal.
"learning_goal": {
"learning_standard_info": {
# Construct a GUID for the ELA21.AAS.11.11c Standard node.
# This is a non-root node, so it has both Document and Item IDs.
"case_guid": {
"case_document_id": "bfc264b3-b4d1-4780-84ff-26b12e6945a6",
"case_item_id": "6d922f1f-b580-42a1-b6d2-5ee5b39c561d",
}
}
},
},
{
"title": "Spelling",
"description": "How well you spelled all the words.",
"levels": [
{"title": "Perfect", "description": "No mistakes.", "points": 20},
{"title": "Great", "description": "A mistake or two.", "points": 15},
{"title": "Needs Work", "description": "Many mistakes.", "points": 5},
],
# Each Criterion can have one learning goal.
"learning_goal": {
"learning_standard_info": {
# Construct a GUID for the ELA21.AAS.11.22a Standard node.
# This is a non-root node, so it has both Document and Item IDs.
"case_guid": {
"case_document_id": "bfc264b3-b4d1-4780-84ff-26b12e6945a6",
"case_item_id": "a684609a-c3ec-42da-8b7f-7a325b31ea4a",
}
}
},
},
]
}
rubric = (
service.courses()
.courseWork()
.rubrics()
.create(
courseId=course_id,
courseWorkId=coursework_id,
body=body,
# Specify the preview version while the feature is in Developer Preview.
# Learning standards and goals are supported in V1_20260316_PREVIEW and
# later.
previewVersion="V1_20260316_PREVIEW")
.execute()
)
print(f"Rubric created with ID {rubric.get('id')}")
सीखने के लक्ष्य वापस पाना
किसी असाइनमेंट, सवाल या मटीरियल पर, सीखने के मौजूदा लक्ष्य देखने के लिए, CourseWork.learningGoals फ़ील्ड की जांच करें. सीखने के हर लक्ष्य वाले ऑब्जेक्ट में, रूट-लेवल दस्तावेज़ का शीर्षक और सीखने के स्टैंडर्ड का कोड शामिल होता है.
ध्यान दें कि शिक्षक, Classroom के यूज़र इंटरफ़ेस (यूआई) में, कोर्सवर्क और मटीरियल में स्किल टैग भी जोड़ सकते हैं. एपीआई में, स्किल टैग ऐक्सेस नहीं किए जा सकते.
{
"course_id": "123456789",
"id": "987654321",
"title": "Test ELA Assignment",
"state": "PUBLISHED",
"learning_goals": [
{
"learning_standard_info": {
"standard_code": "ELA21.AAS.11.11c",
"document_title": "AAS English Language Arts (2021)",
"case_guid": {
"case_document_id": "bfc264b3-b4d1-4780-84ff-26b12e6945a6",
"case_item_id": "6d922f1f-b580-42a1-b6d2-5ee5b39c561d",
},
"source_data_availability_status": "LEARNING_STANDARD_AVAILABLE"
},
"title": "Compose argumentative texts by stating a topic, providing reasons that support the argument, and providing an appropriate conclusion related to the topic."
},
{
"learning_standard_info": {
"standard_code": "ELA21.AAS.11.22a",
"document_title": "AAS English Language Arts (2021)",
"case_guid": {
"case_document_id": "bfc264b3-b4d1-4780-84ff-26b12e6945a6",
"case_item_id": "a684609a-c3ec-42da-8b7f-7a325b31ea4a",
},
"source_data_availability_status": "LEARNING_STANDARD_AVAILABLE"
},
"title": "Identify a sentence that uses correct capitalization (i.e., beginning of sentence, names, cities, states, countries, towns, titles, days, months)."
}]
}
Rubric के जवाबों में भी ऐसा ही डेटा दिखता है. इसमें हर मानदंड के लिए, एक learningGoal शामिल होता है.