Người dùng có thể đặt mục tiêu học tập cho các khoá học và bài tập trong Google Lớp học.
Các mục tiêu học tập tương tự cũng được cung cấp trong Classroom API. Bạn có thể đặt, truy xuất và sửa đổi các bộ tiêu chuẩn học tập trên tài nguyên Course và mục tiêu học tập trên tài nguyên CourseWork và Rubric. Hướng dẫn này mô tả cách truy cập và sửa đổi mục tiêu học tập cũng như bộ tiêu chuẩn bằng Classroom API.
Cách hoạt động
Nguồn dữ liệu
Mục tiêu học tập trong Lớp học dựa vào các giá trị nhận dạng duy nhất trên toàn cầu (GUID) ổn định do Satchel Rosetta Exchange (trước đây là Mạng lưới CASE) cung cấp. Các tiêu chuẩn trong Exchange được sắp xếp thành các cây nút, trong đó nút gốc là một bộ tiêu chuẩn toàn diện cho một chủ đề cụ thể và các nút con mô tả kết quả học tập ngày càng cụ thể hơn. Bạn có thể đặt giá trị nhận dạng cho mọi nút có mã tiêu chuẩn hoặc nút lá trong mạng là mục tiêu học tập trên CourseWork, trong khi mọi nút không phải là nút lá đều có thể được đặt làm bộ tiêu chuẩn học tập trên Course.
- Bộ tiêu chuẩn học tập cho tài nguyên
Coursethể hiện nhóm tiêu chuẩn xuất hiện trong giao diện người dùng Lớp học khi giáo viên gắn thẻ mục tiêu học tập. - Mục tiêu học tập được đính kèm vào tài nguyên
CourseWork,CourseWorkMaterialhoặcRubricthể hiện tiêu chuẩn hoặc kỹ năng liên quan đến bài tập, câu hỏi, tài liệu hoặc tiêu chí chấm điểm cụ thể đó.
Google sử dụng 5 thông tin từ Satchel Rosetta Exchange:
- Mã nhận dạng tài liệu: Một GUID cho một nút cấp gốc. Mã nhận dạng này khớp với một vùng chứa tiêu chuẩn cấp cao nhất và là mã nhận dạng chung cho tất cả các nút con.
- Tiêu đề tài liệu: Tên của toàn bộ tài liệu tiêu chuẩn mà con người có thể đọc được.
- Mã mặt hàng: GUID cho một tiêu chuẩn duy nhất (tức là một nút không phải là nút gốc).
- Tiêu đề chuẩn: Văn bản mô tả mà con người có thể đọc được của một tiêu chuẩn duy nhất.
- Mã tiêu chuẩn: Chữ viết tắt mà con người có thể đọc được cho một tiêu chuẩn cụ thể.
Tìm giá trị cho các tiêu chuẩn và mục tiêu
Để biết cách tìm các giá trị này, hãy xem xét một ví dụ về tiêu chuẩn Toán học của tiểu bang New York. Bắt đầu từ nút gốc:
Hình 1: Chế độ xem của một nút gốc khi được chọn trong Satchel Rosetta Exchange. Phần này cho biết tiêu đề và mã nhận dạng của tài liệu, thường xuất hiện ở tất cả các nút trên trang này.
Từ chế độ xem trong Hình 1, bạn có thể trích xuất các giá trị sau:
- Mã tài liệu:
c649d172-d7cb-11e8-824f-0242ac160002 - Tiêu đề tài liệu:
New York State Next Generation Mathematics Learning Standards
Để xem giá trị của một tiêu chuẩn riêng lẻ, hãy nhấp vào tiêu chuẩn đó rồi mở rộng siêu dữ liệu của tiêu chuẩn:
Hình 2: Chế độ xem siêu dữ liệu của một nút không phải là nút gốc khi được chọn trong Satchel Rosetta Exchange. Thông tin này cho biết mã mặt hàng, mã tiêu chuẩn và tiêu đề tiêu chuẩn. Các giá trị này chỉ dành riêng cho tiêu chuẩn này.
Trong chế độ xem ở Hình 2, bạn có thể tìm thấy các giá trị sau:
- Mã mặt hàng:
70d64c79-d7cc-11e8-824f-0242ac160002 - Tiêu đề chuẩn:
Understand that the digits of a three-digit number represent amounts of hundreds, tens, and ones. - Mã tiêu chuẩn:
NY-2.NBT.4
Xin lưu ý rằng bạn cũng có thể trích xuất mã nhận dạng tài liệu và mã nhận dạng mục từ URL Satchel Rosetta Exchange của mỗi nút. Các URL này tuân theo mẫu https://rosetta.commongoodlt.com/{document_id}/{item_id}.
Số lượng mặt hàng được liên kết tối đa
- Mỗi
Coursecó thể có tối đa 5 bộ tiêu chuẩn học tập. - Mỗi
CourseWorkcó thể có tối đa 10 mục tiêu học tập. - Mỗi Tiêu chí chấm điểm
Criterioncó thể có 1 mục tiêu học tập.
Quản lý bộ tiêu chuẩn học tập của khoá học
Sửa đổi bộ tiêu chuẩn học tập
Để sửa đổi các bộ tiêu chuẩn học tập Course, hãy điền vào trường Course.learningStandardSettings bằng các đối tượng standardSets. Mỗi standardSet phải chứa một đối tượng caseGuid, trong đó có một caseDocumentId và có thể có một caseItemId (không bắt buộc).
Bạn có thể thêm các bộ tiêu chuẩn học tập bằng cách sử dụng mọi yêu cầu Course sửa đổi, chẳng hạn như courses.create() hoặc courses.patch() bằng mặt nạ cập nhật learningStandardSettings.
Ví dụ sau đây đặt 2 bộ tiêu chuẩn cho một khoá học hiện có.
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')}")
Truy xuất bộ tiêu chuẩn học tập
Để xem các nhóm tiêu chuẩn học tập hiện tại của một khoá học, hãy kiểm tra trường Course.learningStandardSettings. Trường này chứa một loạt các đối tượng standardSets và có thể trống nếu không có bộ tiêu chuẩn học tập nào trên khoá học.
Xin lưu ý rằng mỗi standardSet trong phản hồi đều chứa nội dung mô tả của tiêu chuẩn và tiêu đề tài liệu gốc của tiêu chuẩn đó. Giáo viên và học viên cũng sẽ thấy những văn bản này trên giao diện người dùng của Lớp học. Bạn cũng nhận được sourceDataAvailabilityStatus, cho biết liệu tiêu chuẩn có trong Satchel Rosetta Exchange hay không.
{
"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"
}]
}
}
Quản lý mục tiêu học tập của Bài tập trên lớp và Tiêu chí chấm điểm
Sửa đổi mục tiêu học tập
Bạn có thể đính kèm mục tiêu học tập vào các tài nguyên CourseWork, CourseWorkMaterial và Tiêu chí chấm điểm Criterion trong mọi yêu cầu biến đổi. Đặt giá trị nhận dạng tài liệu và mặt hàng trong các trường CourseWork.learningGoals hoặc Rubric.Criterion.learningGoal. Đây là các giá trị nhận dạng giống như đã mô tả trước đó.
Xin lưu ý rằng mục tiêu học tập được đính kèm vào tiêu chí Rubric phải đã được đính kèm vào bài tập mà Rubric được liên kết.
Ví dụ sau đây sẽ tạo một bài tập CourseWork có 2 mục tiêu học tập được đính kèm.
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')}")
Ví dụ sau đây sẽ tạo một Rubric có mục tiêu học tập được đính kèm vào từng tiêu chí.
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')}")
Truy xuất mục tiêu học tập
Để xem các mục tiêu học tập hiện tại trong bài tập, câu hỏi hoặc tài liệu, hãy kiểm tra trường CourseWork.learningGoals. Mỗi đối tượng mục tiêu học tập đều chứa tiêu đề tài liệu cấp gốc và mã tiêu chuẩn học tập.
Xin lưu ý rằng giáo viên cũng có thể thêm thẻ kỹ năng vào bài tập và tài liệu trong giao diện người dùng Lớp học. Bạn không thể truy cập vào thẻ kỹ năng trong 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)."
}]
}
Dữ liệu tương tự được trả về bằng các phản hồi Rubric, chứa một learningGoal cho mỗi tiêu chí.