إدارة أهداف التعلّم

يمكن للمستخدمين تحديد أهداف التعلّم للدورات التدريبية والواجبات في Google Classroom. تظهر أهداف التعلّم نفسها أيضًا في Classroom API. يمكنك ضبط مجموعات معايير التعلّم واستردادها وتعديلها في موارد Course وأهداف التعلّم في موارد CourseWork و Rubric. يوضّح هذا الدليل كيفية الوصول إلى أهداف التعلّم ومجموعات المعايير وتعديلها باستخدام Classroom API.

آلية العمل

مصدر البيانات

تستند أهداف التعلّم في Classroom إلى معرّفات فريدة وثابتة على مستوى العالم (GUID) يوفّرها Satchel Rosetta Exchange (المعروف سابقًا باسم CASE Network). يتم تنظيم المعايير في Exchange في شكل أشجار من العُقد، حيث تكون العُقدة الجذرية هي مجموعة معايير التعلُّم شاملة لموضوع معيّن وتصف العُقد الفرعية نتائج التعلّم الأكثر تحديدًا تدريجيًا. يمكن ضبط المعرّف لأي عُقدة تحتوي على رمز معيار أو عُقدة ورقة في الشبكة كهدف تعلّم في CourseWork، بينما يمكن ضبط أي عُقدة غير ورقة كمجموعة معايير تعلّم في Course.

  • تمثّل مجموعات معايير التعلّم لمورد Course مجموعة المعايير التي تظهر في واجهة مستخدم Classroom عندما يضع المعلّمون علامة على أهداف التعلّم.
  • تمثّل أهداف التعلّم المرفقة بمورد CourseWork أو CourseWorkMaterial أو Rubric المعيار أو المهارات المرتبطة بهذا الواجب أو السؤال أو المادة أو معيار قواعد التقييم المحدّد.

تستخدم Google خمسة أنواع من المعلومات من Satchel Rosetta Exchange:

  • رقم تعريف المستند: هو معرّف فريد وثابت على مستوى العالم لعُقدة على مستوى الجذر. يتطابق هذا المعرّف مع حاوية معايير على المستوى الأعلى وهو شائع بين جميع العُقد الفرعية.
  • عنوان المستند: هو الاسم الذي يمكن لشخص عادي قراءته لمستند المعيار بالكامل.
  • معرّف السلعة: هو معرّف فريد وثابت على مستوى العالم لمعيار واحد (أي عُقدة غير جذرية).
  • عنوان المعيار: هو النص الوصفي الذي يمكن لشخص عادي قراءته لمعيار واحد.
  • رمز المعيار: هو اختصار يمكن لشخص عادي قراءته لمعيار معيّن.

العثور على قيم المعايير والأهداف

لفهم مكان العثور على هذه القيم، لنأخذ مثالاً على معيار الرياضيات من ولاية نيويورك. ابدأ من العُقدة الجذرية:

عرض لعقدة جذر عند اختيارها في 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 في قواعد التقييم على هدف تعلّم واحد.

إدارة مجموعات معايير التعلّم في `Course`

تعديل مجموعات معايير التعلّم

لتعديل مجموعات معايير التعلّم في Course، املأ الحقل Course.learningStandardSettings بكائنات standardSets. يجب أن يحتوي كل 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` و`Rubric`

تعديل أهداف التعلّم

يمكن إرفاق أهداف التعلّم بموارد 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 واحد لكل معيار.