Mengelola sasaran pembelajaran

Pengguna dapat menetapkan sasaran pembelajaran untuk kursus dan tugas di Google Classroom. Sasaran pembelajaran yang sama juga ditampilkan di Classroom API. Anda dapat menetapkan, mengambil, dan mengubah kumpulan standar pembelajaran pada resource Course dan sasaran pembelajaran pada resource CourseWork, CourseWorkMaterial, dan Rubric. Panduan ini menjelaskan cara mengakses dan mengubah sasaran pembelajaran dan set standar menggunakan Classroom API.

Pratinjau: Dukungan API untuk set standar pembelajaran di Course dan tujuan pembelajaran di CourseWork, CourseWorkMaterial, dan Rubric kini tersedia sebagai bagian dari Program Pratinjau Developer Google Workspace. Fitur ini tersedia di V1_20260316_PREVIEW dan yang lebih baru. Kami berharap fitur ini tersedia secara umum di Classroom API pada awal Kuartal 4 2026. Lihat API pratinjau akses untuk mempelajari lebih lanjut.

Cara kerjanya

Sumber data

Tujuan pembelajaran di Classroom mengandalkan ID unik global (GUID) yang stabil yang disediakan oleh Satchel Rosetta Exchange (sebelumnya CASE Network). Standar di Exchange disusun dalam struktur hierarki node, dengan root adalah set standar komprehensif untuk subjek tertentu dan node turunan menjelaskan hasil pembelajaran yang semakin spesifik. ID untuk setiap node dengan kode standar atau node daun di jaringan dapat ditetapkan sebagai tujuan pembelajaran di CourseWork, sementara setiap node non-daun dapat ditetapkan sebagai standar pembelajaran yang ditetapkan di Course.

• Set standar pembelajaran untuk resource Course mewakili grup standar yang muncul di UI Classroom saat pengajar memberi tag pada sasaran pembelajaran.
• Sasaran pembelajaran yang dilampirkan ke resource CourseWork, CourseWorkMaterial, atau Rubric mewakili standar atau keterampilan yang terkait dengan tugas, pertanyaan, materi, atau kriteria rubrik tertentu.

Google menggunakan lima informasi dari Satchel Rosetta Exchange:

• ID Dokumen: GUID untuk node tingkat root. ID ini cocok dengan penampung standar tingkat teratas dan umum untuk semua node turunan.
• Judul Dokumen: Nama seluruh dokumen standar yang dapat dibaca manusia.
• ID Item: GUID untuk satu standar (yaitu, node non-root).
• Judul Standar: Teks deskriptif yang dapat dibaca manusia dari satu standar.
• Kode Standar: Singkatan yang dapat dibaca manusia untuk standar tertentu.

Menemukan nilai untuk standar dan sasaran

Untuk memahami tempat menemukan nilai ini, pertimbangkan contoh standar Matematika dari Negara Bagian New York. Mulai dari node root:

Gambar 1: Tampilan node root saat dipilih di Satchel Rosetta Exchange. Bagian ini menampilkan judul dokumen dan ID dokumen, yang umum untuk semua node di halaman ini.

Dari tampilan pada Gambar 1, Anda dapat mengekstrak nilai berikut:

• ID Dokumen: c649d172-d7cb-11e8-824f-0242ac160002
• Judul Dokumen: New York State Next Generation Mathematics Learning Standards

Untuk mendapatkan nilai untuk setiap standar, klik standar dan luaskan metadatanya:

Gambar 2: Tampilan metadata node non-root saat dipilih di Satchel Rosetta Exchange. Bagian ini menampilkan ID item, kode standar, dan judul standar. Nilai ini hanya khusus untuk standar ini.

Dari tampilan di Gambar 2, Anda dapat menemukan nilai berikut:

• ID Item: 70d64c79-d7cc-11e8-824f-0242ac160002
• Judul Standar: Understand that the digits of a three-digit number represent amounts of hundreds, tens, and ones.
• Kode Standar: NY-2.NBT.4

Perhatikan bahwa ID dokumen dan item juga dapat diekstrak dari URL Satchel Rosetta Exchange setiap node. URL ini mengikuti pola https://rosetta.commongoodlt.com/{document_id}/{item_id}.

Item tertaut maksimum

• Setiap Course dapat memiliki hingga 5 set standar pembelajaran.
• Setiap CourseWork dapat memiliki hingga 10 sasaran pembelajaran.
• Setiap Rubrik Criterion dapat memiliki 1 sasaran pembelajaran.

Mengelola set standar pembelajaran Kursus

Mengubah set standar pembelajaran

Untuk mengubah set standar pembelajaran Course, isi kolom Course.learningStandardSettings dengan objek standardSets. Setiap standardSet harus berisi objek caseGuid, yang mencakup caseDocumentId dan opsional caseItemId.

Anda dapat menambahkan set standar pembelajaran menggunakan permintaan perubahan Course apa pun, seperti courses.create() atau courses.patch() dengan masker update learningStandardSettings.

Contoh berikut menetapkan dua set standar pada kursus yang ada.

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')}")

Mengambil set standar pembelajaran

Untuk melihat set standar pembelajaran saat ini dalam kursus, periksa kolom Course.learningStandardSettings. Kolom ini berisi serangkaian objek standardSets, dan dapat kosong jika tidak ada kumpulan standar pembelajaran di kursus.

Perhatikan bahwa setiap standardSet dalam respons berisi deskripsi standar dan judul dokumen root-nya. Teks ini juga muncul untuk pengajar dan siswa di UI Classroom. Anda juga menerima sourceDataAvailabilityStatus, yang menunjukkan apakah standar tersedia di 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"
      }
    ]
  }
}

Mengelola sasaran pembelajaran CourseWork, CourseWorkMaterial, dan Rubric

Mengubah sasaran pembelajaran

Sasaran pembelajaran dapat dilampirkan ke resource CourseWork, CourseWorkMaterial, dan Rubrik Criterion dalam permintaan mutasi apa pun. Tetapkan ID dokumen dan item di kolom CourseWork.learningGoals atau Rubric.Criterion.learningGoal. Ini adalah ID yang sama seperti yang dijelaskan sebelumnya.

Perhatikan bahwa sasaran pembelajaran yang dilampirkan ke kriteria Rubric harus sudah dilampirkan ke tugas yang ditautkan ke Rubric.

Contoh berikut membuat tugas CourseWork dengan dua sasaran pembelajaran yang dilampirkan.

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')}")

Contoh berikut membuat Rubric dengan tujuan pembelajaran yang dilampirkan pada setiap kriteria.

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')}")

Mengambil sasaran pembelajaran

Untuk melihat sasaran pembelajaran saat ini pada tugas, pertanyaan, atau materi, periksa kolom CourseWork.learningGoals. Setiap objek sasaran pembelajaran berisi judul dokumen tingkat root dan kode standar pembelajaran.

Perhatikan bahwa pengajar juga dapat menambahkan tag keterampilan ke tugas dan materi di UI Classroom. Tag keterampilan tidak dapat diakses di 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."
    }
  ]
}

Data serupa ditampilkan dengan respons Rubric, yang berisi satu learningGoal per kriteria.