ผู้ใช้สามารถตั้งเป้าหมายการเรียนรู้สำหรับหลักสูตรและงานใน Google Classroom ได้
เป้าหมายการเรียนรู้เดียวกันนี้จะแสดงใน Classroom API ด้วย คุณสามารถ
ตั้งค่า ดึงข้อมูล และแก้ไขชุดมาตรฐานการเรียนรู้ในทรัพยากร Course
และเป้าหมายการเรียนรู้ในทรัพยากร CourseWork และ
Rubric คู่มือนี้อธิบายวิธีเข้าถึงและแก้ไข
เป้าหมายการเรียนรู้และชุดมาตรฐานโดยใช้ Classroom API
วิธีการทำงาน
แหล่งข้อมูล
เป้าหมายการเรียนรู้ใน Classroom ใช้ตัวระบุที่ไม่ซ้ำกันทั่วโลก (GUID) ที่เสถียร
ซึ่งได้รับจาก Satchel Rosetta Exchange
(เดิมคือ CASE Network) มาตรฐานใน Exchange จัดระเบียบเป็นโครงสร้างแบบต้นไม้ของ
โหนด โดยรูทคือชุดมาตรฐานที่ครอบคลุมสำหรับวิชาหนึ่งๆ
และโหนดลูกจะอธิบายผลการเรียนรู้ที่เฉพาะเจาะจงมากขึ้นเรื่อยๆ คุณสามารถตั้งค่าตัวระบุสำหรับโหนดที่มีรหัสมาตรฐานหรือโหนดใบในเครือข่ายเป็นเป้าหมายการเรียนรู้ใน CourseWork ได้ ในขณะที่ตั้งค่าโหนดที่ไม่ใช่ใบเป็นชุดมาตรฐานการเรียนรู้ใน Course ได้
- ชุดมาตรฐานการเรียนรู้สำหรับแหล่งข้อมูล
Courseแสดงถึงกลุ่มมาตรฐานที่ปรากฏใน UI ของ Classroom เมื่อครูติดแท็กเป้าหมายการเรียนรู้ - เป้าหมายการเรียนรู้ที่แนบไปกับทรัพยากร
CourseWorkCourseWorkMaterialหรือRubricแสดงถึงมาตรฐานหรือทักษะที่เชื่อมโยงกับงาน คำถาม สื่อ หรือเกณฑ์การให้คะแนนที่เฉพาะเจาะจง
Google ใช้ข้อมูล 5 อย่างจาก Satchel Rosetta Exchange ดังนี้
- รหัสเอกสาร: GUID สำหรับโหนดระดับรูท รหัสนี้ตรงกับคอนเทนเนอร์มาตรฐานระดับบนสุด และใช้ร่วมกันในโหนดย่อยทั้งหมด
- ชื่อเอกสาร: ชื่อเอกสารมาตรฐานทั้งหมดที่มนุษย์อ่านได้
- รหัสสินค้า: GUID สำหรับมาตรฐานเดียว (โหนดที่ไม่ใช่รูท)
- ชื่อมาตรฐาน: ข้อความอธิบายที่มนุษย์อ่านได้ของ มาตรฐานเดียว
- รหัสมาตรฐาน: ตัวย่อที่มนุษย์อ่านได้สำหรับมาตรฐานที่เฉพาะเจาะจง
ค้นหาค่าสำหรับมาตรฐานและเป้าหมาย
หากต้องการทราบว่าค่าเหล่านี้อยู่ที่ใด ให้ดูตัวอย่างมาตรฐานคณิตศาสตร์ จากรัฐนิวยอร์ก เริ่มที่โหนด ราก
รูปที่
1: มุมมองของโหนดรูทเมื่อเลือกใน Satchel Rosetta Exchange ซึ่งจะแสดง
ชื่อเอกสารและรหัสเอกสาร ซึ่งเป็นข้อมูลที่ใช้ร่วมกันในโหนดทั้งหมดในหน้านี้
จากมุมมองในรูปที่ 1 คุณสามารถดึงค่าต่อไปนี้ได้
- รหัสเอกสาร:
c649d172-d7cb-11e8-824f-0242ac160002 - ชื่อเอกสาร:
New York State Next Generation Mathematics Learning Standards
หากต้องการดูค่าสำหรับมาตรฐานแต่ละรายการ ให้คลิกมาตรฐานและขยายข้อมูลเมตาของมาตรฐานนั้น
รูปที่
2: มุมมองของข้อมูลเมตาของโหนดที่ไม่ใช่รูทเมื่อเลือกใน Satchel Rosetta
Exchange ซึ่งจะแสดงรหัสสินค้า รหัสมาตรฐาน และชื่อมาตรฐาน ค่าเหล่านี้
ใช้กับมาตรฐานนี้เท่านั้น
จากมุมมองในรูปที่ 2 คุณจะเห็นค่าต่อไปนี้
- รหัสสินค้า:
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
โปรดทราบว่าคุณยังดึงข้อมูลรหัสเอกสารและรหัสรายการได้จาก URL ของ Satchel Rosetta Exchange ของแต่ละโหนดด้วย
URL เหล่านี้เป็นไปตามรูปแบบ
https://rosetta.commongoodlt.com/{document_id}/{item_id}
รายการที่ลิงก์สูงสุด
Courseแต่ละรายการมีชุดมาตรฐานการเรียนรู้ได้สูงสุด 5 ชุดCourseWorkแต่ละรายการมีเป้าหมายการเรียนรู้ได้สูงสุด 10 รายการ- Rubric
Criterionแต่ละรายการมีเป้าหมายการเรียนรู้ได้ 1 รายการ
จัดการชุดมาตรฐานการเรียนรู้ของหลักสูตร
แก้ไขชุดมาตรฐานการเรียนรู้
หากต้องการแก้ไขCourseชุดมาตรฐานการเรียนรู้ ให้ป้อนข้อมูลในฟิลด์
Course.learningStandardSettingsด้วยออบเจ็กต์standardSets standardSet แต่ละรายการต้องมีออบเจ็กต์ caseGuid ซึ่งมี caseDocumentId และอาจมี caseItemId
คุณสามารถเพิ่มชุดมาตรฐานการเรียนรู้ได้โดยใช้Courseคำขอเปลี่ยนแปลง เช่น
courses.create() หรือ courses.patch() พร้อมlearningStandardSettingsมาสก์การอัปเดต
ตัวอย่างต่อไปนี้จะตั้งค่าชุดมาตรฐาน 2 ชุดในหลักสูตรที่มีอยู่
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 แต่ละรายการในการตอบกลับมีคำอธิบายของมาตรฐาน
และชื่อเอกสารรูท ข้อความเหล่านี้จะปรากฏต่อครูและนักเรียนใน UI ของ 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
CourseWorkMaterial และแหล่งข้อมูลเกณฑ์การให้คะแนน Criterion
ในคำขอเปลี่ยนแปลงใดก็ได้ ตั้งค่าตัวระบุเอกสารและรายการในช่อง
CourseWork.learningGoals หรือ Rubric.Criterion.learningGoal ซึ่งเป็นตัวระบุเดียวกันกับที่อธิบายไว้ก่อนหน้านี้
โปรดทราบว่าเป้าหมายการเรียนรู้ที่แนบกับRubricเกณฑ์ต้องแนบกับงานที่Rubricลิงก์อยู่แล้ว
ตัวอย่างต่อไปนี้สร้างงาน CourseWork ที่มีเป้าหมายการเรียนรู้ 2 รายการแนบอยู่
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 ออบเจ็กต์เป้าหมายการเรียนรู้แต่ละรายการประกอบด้วย
ชื่อเอกสารระดับรากและรหัสมาตรฐานการเรียนรู้
โปรดทราบว่าครูยังเพิ่มแท็กทักษะลงในหลักสูตรและสื่อการสอนใน UI ของ Classroom ได้ด้วย แท็กทักษะไม่สามารถเข้าถึงได้ใน API
{
"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
ต่อเกณฑ์ 1 รายการ