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

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

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

แหล่งข้อมูล

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

  • ชุดมาตรฐานการเรียนรู้สำหรับแหล่งข้อมูล 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 แต่ละรายการมีชุดมาตรฐานการเรียนรู้ได้สูงสุด 20 ชุด
  • 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 = {
    "learningStandardSettings": {
        # Each Course can have up to 20 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 และแหล่งข้อมูลเกณฑ์การให้คะแนน 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 รายการ