مدیریت اهداف یادگیری

کاربران می‌توانند اهداف یادگیری را برای دوره‌ها و تکالیف در Google Classroom تعیین کنند. همین اهداف یادگیری در Classroom API نیز نمایش داده می‌شوند. می‌توانید مجموعه استانداردهای یادگیری را در منابع Course و اهداف یادگیری را در منابع CourseWork و Rubric تنظیم، بازیابی و اصلاح کنید. این راهنما نحوه دسترسی و اصلاح اهداف یادگیری و مجموعه‌های استاندارد را با استفاده از Classroom API شرح می‌دهد.

چگونه کار می‌کند؟

منبع داده

اهداف یادگیری در Classroom به شناسه‌های منحصر به فرد جهانی (GUID) پایدار ارائه شده توسط Satchel Rosetta Exchange (که قبلاً شبکه CASE نام داشت) متکی هستند. استانداردها در Exchange به صورت درخت‌هایی از گره‌ها سازماندهی شده‌اند، که در آن ریشه یک مجموعه استاندارد جامع برای یک موضوع خاص است و گره‌های فرزند به تدریج نتایج یادگیری خاص‌تری را توصیف می‌کنند. شناسه هر گره با کد استاندارد یا گره برگ در شبکه می‌تواند به عنوان یک هدف یادگیری در CourseWork تنظیم شود، در حالی که هر گره غیر برگ می‌تواند به عنوان یک مجموعه استاندارد یادگیری در Course تنظیم شود.

  • مجموعه استانداردهای یادگیری برای یک منبع Course ، گروهی از استانداردها را نشان می‌دهد که هنگام برچسب‌گذاری اهداف یادگیری توسط معلمان، در رابط کاربری کلاس درس ظاهر می‌شوند.
  • اهداف یادگیری متصل به یک منبع CourseWork ، CourseWorkMaterial یا Rubric ، استاندارد یا مهارت‌های مرتبط با آن تکلیف، سوال، مطلب یا معیار خاص Rubric را نشان می‌دهند.

گوگل از پنج قطعه اطلاعات از Satchel Rosetta Exchange استفاده می‌کند:

  • شناسه سند : یک GUID برای یک گره سطح ریشه. این شناسه با یک کانتینر استانداردهای سطح بالا مطابقت دارد و برای همه گره‌های فرزند مشترک است.
  • عنوان سند : نام قابل خواندن توسط انسان برای کل سند استاندارد.
  • شناسه کالا : یک GUID برای یک استاندارد واحد (یعنی یک گره غیر ریشه).
  • عنوان استاندارد : متن توصیفی قابل خواندن توسط انسان از یک استاندارد واحد.
  • کد استاندارد : یک اختصار قابل خواندن توسط انسان برای یک استاندارد خاص.

یافتن ارزش‌ها برای استانداردها و اهداف

برای فهمیدن اینکه این مقادیر را کجا می‌توان پیدا کرد، یک مثال از استاندارد ریاضیات ایالت نیویورک را در نظر بگیرید. از گره ریشه شروع کنید:

نمای یک گره ریشه هنگام انتخاب در Satchel Rosetta Exchange شکل ۱ : نمای یک گره ریشه هنگام انتخاب در Satchel Rosetta Exchange. این تصویر عنوان سند و شناسه سند را نشان می‌دهد که برای همه گره‌های این صفحه مشترک هستند.

از نمای شکل ۱، می‌توانید مقادیر زیر را استخراج کنید:

  • شناسه سند: c649d172-d7cb-11e8-824f-0242ac160002
  • عنوان سند: New York State Next Generation Mathematics Learning Standards

برای دریافت مقادیر یک استاندارد خاص، روی یک استاندارد کلیک کنید و فراداده‌های آن را باز کنید:

نمای فراداده‌های یک گره غیر ریشه هنگام انتخاب در Satchel Rosetta Exchange شکل ۲ : نمای فراداده‌های یک گره غیر ریشه هنگام انتخاب در Satchel Rosetta Exchange. این تصویر شناسه کالا، کد استاندارد و عنوان استاندارد را نشان می‌دهد. این مقادیر فقط مختص این استاندارد هستند.

با توجه به شکل ۲، می‌توان مقادیر زیر را بدست آورد:

  • شناسه کالا: 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

توجه داشته باشید که شناسه‌های سند و آیتم را می‌توان از آدرس اینترنتی Satchel Rosetta Exchange هر گره نیز استخراج کرد. این آدرس‌های اینترنتی از الگوی https://rosetta.commongoodlt.com/{document_id}/{item_id} پیروی می‌کنند.

حداکثر موارد مرتبط

  • هر Course می‌تواند تا ۵ مجموعه استاندارد یادگیری داشته باشد.
  • هر CourseWork می‌تواند تا ۱۰ هدف یادگیری داشته باشد.
  • هر Criterion روبریک می‌تواند یک هدف یادگیری داشته باشد.

مدیریت مجموعه استانداردهای یادگیری دوره

اصلاح مجموعه استانداردهای یادگیری

برای تغییر مجموعه استانداردهای یادگیری Course ، فیلد Course.learningStandardSettings را با اشیاء standardSets پر کنید. هر standardSet باید حاوی یک شیء caseGuid باشد که شامل یک caseDocumentId و به صورت اختیاری یک caseItemId .

شما می‌توانید مجموعه‌های استاندارد یادگیری را با استفاده از هر درخواست تغییر Course ، مانند courses.create() یا courses.patch() با ماسک به‌روزرسانی learningStandardSettings اضافه کنید.

مثال زیر دو مجموعه استاندارد را روی یک مسیر موجود تنظیم می‌کند.

پایتون 

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 و Rubric Criterion پیوست کرد. شناسه‌های سند و آیتم را در فیلدهای CourseWork.learningGoals یا Rubric.Criterion.learningGoal تنظیم کنید. اینها همان شناسه‌هایی هستند که قبلاً توضیح داده شدند .

توجه داشته باشید که اهداف یادگیری پیوست‌شده به معیارهای Rubric باید قبلاً به تکلیفی که Rubric به آن مرتبط است، پیوست شده باشند.

مثال زیر یک تکلیف CourseWork با دو هدف یادگیری پیوست ایجاد می‌کند.

پایتون 

# 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 ایجاد می‌کند که به هر معیار، یک هدف یادگیری متصل است.

پایتون 

# 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 را بررسی کنید. هر شیء هدف یادگیری شامل عنوان سند سطح ریشه و کد استاندارد یادگیری است.

توجه داشته باشید که معلمان می‌توانند برچسب‌های مهارت را به تکالیف و مطالب درسی در رابط کاربری کلاس درس نیز اضافه کنند. برچسب‌های مهارت در 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 برای هر معیار است.