จัดการเป้าหมายการเรียนรู้

ผู้ใช้สามารถตั้งเป้าหมายการเรียนรู้สำหรับหลักสูตรและงานใน Google Classroom ได้ นอกจากนี้ ระบบยังแสดงเป้าหมายการเรียนรู้เดียวกันใน Classroom API ด้วย คุณสามารถ ตั้งค่า ดึงข้อมูล และแก้ไขชุดมาตรฐานการเรียนรู้ ในทรัพยากรCourseและเป้าหมายการเรียนรู้ ในทรัพยากรCourseWork, CourseWorkMaterialและRubricได้ คู่มือนี้อธิบายวิธีเข้าถึงและแก้ไขเป้าหมายการเรียนรู้และชุดมาตรฐานโดยใช้ Classroom API

วิธีการทำงาน

แหล่งข้อมูล

เป้าหมายการเรียนรู้ใน Classroom อาศัยตัวระบุที่ไม่ซ้ำกันทั่วโลก (GUID) ที่เสถียรซึ่ง จัดหาโดยSatchel Rosetta Exchange (เดิมชื่อ CASE Network) มาตรฐานใน Exchange จะจัดเป็นโครงสร้างแบบต้นไม้ของโหนด โดยรูทจะเป็นชุดมาตรฐานที่ครอบคลุมสำหรับวิชาหนึ่งๆ และโหนดลูกจะอธิบายผลการเรียนรู้ที่เฉพาะเจาะจงมากขึ้นเรื่อยๆ คุณสามารถตั้งค่า ตัวระบุสำหรับโหนดที่มีรหัสมาตรฐานหรือโหนดปลายทางในเครือข่ายเป็น เป้าหมายการเรียนรู้ใน CourseWork ได้ ขณะที่โหนดที่ไม่ใช่โหนดปลายทางจะตั้งค่าเป็น ชุดมาตรฐานการเรียนรู้ใน Course ได้

  • ชุดมาตรฐานการเรียนรู้สำหรับทรัพ0}Courseยากร แสดงถึงกลุ่มมาตรฐานที่ปรากฏใน UI ของ Classroom เมื่อครูติดแท็กเป้าหมายการเรียนรู้
  • เป้าหมายการเรียนรู้ที่แนบกับทรัพยากร CourseWork, CourseWorkMaterial หรือ Rubric แสดงถึงมาตรฐานหรือทักษะที่เกี่ยวข้องกับงาน คำถาม สื่อการสอน หรือเกณฑ์การให้คะแนนที่เฉพาะเจาะจง

Google ใช้ข้อมูล 5 รายการจาก Satchel Rosetta Exchange ดังนี้

  • รหัสเอกสาร: GUID สำหรับโหนดระดับรูท รหัสนี้ตรงกับคอนเทนเนอร์มาตรฐานระดับบนสุดและใช้ร่วมกันในโหนดลูกทั้งหมด
  • ชื่อเอกสาร: ชื่อเอกสารมาตรฐานทั้งหมดที่มนุษย์อ่านได้
  • รหัสสินค้า: GUID สำหรับมาตรฐานเดียว (นั่นคือโหนดที่ไม่ใช่รูท)
  • ชื่อมาตรฐาน: ข้อความอธิบายมาตรฐานเดียวที่มนุษย์อ่านได้
  • รหัสมาตรฐาน: ตัวย่อมาตรฐานที่เฉพาะเจาะจงที่มนุษย์อ่านได้

ค้นหาค่าสำหรับมาตรฐานและเป้าหมาย

หากต้องการทำความเข้าใจว่าค่าเหล่านี้อยู่ที่ใด ให้ดูตัวอย่างมาตรฐานคณิตศาสตร์จากรัฐนิวยอร์ก เริ่มจาก โหนดรูท

มุมมองของโหนดรูทเมื่อเลือกใน Satchel Rosetta Exchange รูปที่ 1: มุมมองของโหนดรูทเมื่อเลือกใน Satchel Rosetta Exchange ซึ่งจะแสดงชื่อเอกสารและรหัสเอกสารที่ใช้ร่วมกันในโหนดทั้งหมดในหน้านี้

จากมุมมองในรูปที่ 1 คุณสามารถดึงค่าต่อไปนี้ได้

  • รหัสเอกสาร: c649d172-d7cb-11e8-824f-0242ac160002
  • ชื่อเอกสาร: New York State Next Generation Mathematics Learning Standards

หากต้องการรับค่าสำหรับมาตรฐานแต่ละรายการ ให้คลิกมาตรฐานและขยายข้อมูลเมตา

มุมมองของข้อมูลเมตาของโหนดที่ไม่ใช่รูทเมื่อเลือกใน Satchel Rosetta Exchange รูปที่ 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 รายการ
  • 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 = {
    "learningStandardSettings": {
        # Each Course can have up to 5 learning standard sets.
        "standardSets": [
            # 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.
            {
                "caseGuid": {
                    "caseDocumentId": "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.
            {
                "caseGuid": {
                    "caseDocumentId": "bfc264b3-b4d1-4780-84ff-26b12e6945a6",
                    "caseItemId": "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",
  "learningStandardSettings": {
    "standardSets": [
      {
        "caseGuid": {
          "caseDocumentId": "c649d172-d7cb-11e8-824f-0242ac160002"
        },
        "documentTitle": "New York State Next Generation Mathematics Learning Standards",
        "sourceDataAvailabilityStatus": "LEARNING_STANDARD_AVAILABLE"
      },
      {
        "caseGuid": {
          "caseDocumentId": "bfc264b3-b4d1-4780-84ff-26b12e6945a6",
          "caseItemId": "ada2cc30-7d6d-494e-8c6b-c998bae98f0b"
        },
        "documentTitle": "AAS English Language Arts (2021)",
        "standardTitle": "Kindergarten",
        "sourceDataAvailabilityStatus": "LEARNING_STANDARD_AVAILABLE"
      }
    ]
  }
}

จัดการเป้าหมายการเรียนรู้ของ CourseWork, CourseWorkMaterial และเกณฑ์การให้คะแนน

แก้ไขเป้าหมายการเรียนรู้

คุณสามารถแนบเป้าหมายการเรียนรู้กับทรัพยากร 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.
    "learningGoals": [
        {
            "learningStandardInfo": {
                # 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.
                "caseGuid": {
                    "caseDocumentId": "bfc264b3-b4d1-4780-84ff-26b12e6945a6",
                    "caseItemId": "6d922f1f-b580-42a1-b6d2-5ee5b39c561d",
                }
            }
        },
        {
            "learningStandardInfo": {
                # 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.
                "caseGuid": {
                    "caseDocumentId": "bfc264b3-b4d1-4780-84ff-26b12e6945a6",
                    "caseItemId": "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.
            "learningGoal": {
                "learningStandardInfo": {
                    # 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.
                    "caseGuid": {
                        "caseDocumentId": "bfc264b3-b4d1-4780-84ff-26b12e6945a6",
                        "caseItemId": "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.
            "learningGoal": {
                "learningStandardInfo": {
                    # 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.
                    "caseGuid": {
                        "caseDocumentId": "bfc264b3-b4d1-4780-84ff-26b12e6945a6",
                        "caseItemId": "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",
  "learningGoals": [
    {
      "id": "871768554412",
      "courseId": "123456789",
      "learningStandardInfo": {
        "standardCode": "ELA21.AAS.11.22a",
        "caseGuid": {
          "caseDocumentId": "bfc264b3-b4d1-4780-84ff-26b12e6945a6",
          "caseItemId": "a684609a-c3ec-42da-8b7f-7a325b31ea4a"
        }
      },
      "title": "Identify a sentence that uses correct capitalization (i.e., beginning of sentence, names, cities, states, countries, towns, titles, days, months)."
    },
    {
      "id": "871768554411",
      "courseId": "123456789",
      "learningStandardInfo": {
        "standardCode": "ELA21.AAS.11.11c",
        "caseGuid": {
          "caseDocumentId": "bfc264b3-b4d1-4780-84ff-26b12e6945a6",
          "caseItemId": "6d922f1f-b580-42a1-b6d2-5ee5b39c561d"
        }
      },
      "title": "Compose argumentative texts by stating a topic, providing reasons that support the argument, and providing an appropriate conclusion related to the topic."
    }
  ]
}

ระบบจะแสดงผลข้อมูลที่คล้ายกันในการตอบกลับ Rubric ซึ่งมี learningGoal 1 รายการต่อเกณฑ์