Điểm

Tài liệu này giới thiệu các khái niệm về chấm điểm có liên quan đến Classroom API.

Hãy xem bài viết Xem điểm và theo dõi bài tập để tìm hiểu về quy trình chấm điểm của giáo viên trong ứng dụng Google Lớp học.

CourseWork và StudentSubmissions

Trong Google Lớp học, học viên nộp StudentSubmissions cho bài tập CourseWork trong Course. CourseWork có thể được chấm điểm hoặc không được chấm điểm. Nếu được chấm điểm, CourseWork sẽ có giá trị maxPoints. Giá trị này cho biết tổng số điểm mà bài tập được tính. Nếu maxPoints bằng 0 hoặc không được chỉ định, thì bài tập sẽ không được chấm điểm.

Đối với bài tập được chấm điểm, giáo viên sẽ đặt draftGrade điểm trên StudentSubmission trước khi trả bài cho học viên. Khi bài tập được trả lại trong ứng dụng Lớp học, assignedGrade sẽ tự động được đặt trên StudentSubmission, có cùng giá trị với draftGrade hiện tại. Nhà phát triển có thể thiết lập cả hai trường này và phải mô phỏng hành vi của ứng dụng Lớp học. Ví dụ: bạn không thể đặt assignedGrade mà không có draftGrade. Cả hai trường đều được biểu thị bằng số thập phân và nếu chưa được đặt, thì có nghĩa là giáo viên chưa đặt điểm tương ứng. Hãy xem phần tạo và quản lý điểm để biết ví dụ về mã đọc, thiết lập và trả về điểm.

Học viên có thể gửi nhiều bài cho cùng một bài tập CourseWork, đồng thời trạng thái nộp bài và nhật ký điểm sẽ được theo dõi trong StudentSubmission.submissionHistory.

Bài tập bị nộp muộn, được miễn và bị thiếu trong CourseWork

Khi bài tập CourseWork được giao, hệ thống sẽ tạo phần giữ chỗ StudentSubmissions cho từng học viên, ngay cả khi học viên chưa tương tác với bài tập tương ứng. Giáo viên có thể đặt dueDate vào ngày CourseWork và StudentSubmissions liên quan sẽ được đánh dấu bằng trường late (đặt thành true) nếu học viên không nộp bài tập trước ngày đó. Giáo viên cũng có thể tắt tính năng nộp bài muộn bằng một chế độ cài đặt trong ứng dụng Lớp học.

Ngoài ra, những StudentSubmissions chưa được gửi trước dueDate sẽ được chú thích là bị thiếu trong sổ điểm của Lớp học. Giáo viên cũng có thể đánh dấu bài nộp là còn thiếu theo cách thủ công trong ứng dụng Lớp học. Bài tập còn thiếu sẽ tự động được đánh dấu bằng biểu tượng draftGrade. Giáo viên có thể tuỳ chỉnh biểu tượng này nhưng theo mặc định, biểu tượng này sẽ là 0.

Giáo viên có thể đánh dấu bài nộp còn thiếu là đã hoàn thành hoặc được miễn. StudentSubmissions được đánh dấu là đã hoàn thành sẽ bị xoá trường draftGrade mặc định cho đến khi giáo viên đặt một trường mới theo cách thủ công. StudentSubmissions được đánh dấu là được miễn sẽ bị xoá khỏi cách tính tổng điểm, bao gồm cả khoảng thời gian chấm điểm.

Lưu ý: Bạn không thể phân biệt rõ ràng các trạng thái hoàn tất, thiếu và được miễn của StudentSubmissions trong API. Nếu hành vi này ảnh hưởng đến ứng dụng của bạn, hãy để lại ý kiến phản hồi trong vấn đề này để mô tả tác động đến trường hợp sử dụng của bạn.

Hãy xem bài viết trợ giúp chấm điểm và trả bài tập để tìm hiểu thêm về cách giáo viên có thể xử lý bài tập đã nộp.

Tổng điểm và hệ thống chấm điểm

Classroom hỗ trợ nhiều hệ thống chấm điểm để tính điểm tổng kết của học viên trong khoá học. Bạn có thể tính tổng điểm trực tiếp, tính trọng số theo danh mục hoặc không tính tổng điểm.

Hãy xem bài viết thiết lập điểm số để tìm hiểu về các hệ thống chấm điểm khác nhau kèm theo ví dụ.

Một số điểm chính:

• Tài nguyên Course có một đối tượng gradebookSettings chứa thông tin chi tiết về chế độ cài đặt điểm số của khoá học.
  • calculationType chỉ định phương thức tính toán cho khoá học.
  • displaySettings chỉ định những người có thể xem điểm tổng thể trong ứng dụng Lớp học. Bạn nên tuân thủ quy định này trong ứng dụng của riêng mình nếu có thể. Ví dụ: nếu học viên không xem được tổng điểm của mình trong Lớp học, thì bạn cũng không nên cho họ xem tổng điểm trong ứng dụng của bạn.
  • gradeCategories chứa danh sách các danh mục chấm điểm được định cấu hình cho khoá học, bao gồm cả tên hiển thị, tỷ lệ phần trăm trọng số và điểm mặc định cho các bài tập tương ứng.
• Nếu một khoá học sử dụng cách chấm điểm theo trọng số, bạn có thể cần chuẩn hoá trọng số trong trường hợp không có danh mục. Ví dụ: nếu trọng số danh mục là 20% cho bài tập về nhà, 10% cho bài tập thực hành và 70% cho bài kiểm tra, nhưng thực tế không có bài tập thực hành nào, thì Lớp học sẽ điều chỉnh trọng số thành khoảng 22% cho bài tập về nhà và khoảng 78% cho bài kiểm tra khi tính điểm tổng thể. Nếu muốn phản ánh điểm tổng kết của Lớp học trong ứng dụng, bạn cần thực hiện tương tự.

Giai đoạn chấm điểm

Giáo viên có thể nhóm CourseWork bài tập trong một khoá học thành các khoảng thời gian riêng biệt được gọi là kỳ chấm điểm. Bạn có thể dùng giai đoạn chấm điểm để lọc bài tập trong chế độ xem sổ điểm và tạo các nhóm riêng biệt để tính toán tổng điểm.

Ví dụ: giáo viên có thể tạo các khoảng thời gian chấm điểm của học kỳ "mùa xuân" và "mùa thu". Tổng điểm cho học kỳ mùa xuân sẽ chỉ bao gồm StudentSubmissions đến hạn trong phạm vi ngày của học kỳ mùa xuân.

Hệ thống chấm điểm được thiết lập cho khoá học sẽ áp dụng cho các giai đoạn chấm điểm. Vì vậy, nếu các giai đoạn chấm điểm ví dụ vào mùa xuân và mùa thu nêu trên được thiết lập cho một khoá học sử dụng danh mục chấm điểm có trọng số, thì cuối cùng sẽ có 3 bộ tổng điểm cho học viên:

• Điểm tổng kết của tất cả bài tập trong khoá học.
• Điểm tổng kết của tất cả bài tập trong khoảng thời gian mùa xuân.
• Điểm tổng kết của tất cả bài tập trong khoảng thời gian của học kỳ mùa thu.

Cả ba cách này đều tính tổng điểm theo danh mục có trọng số.

Hãy xem thông báo về khoảng thời gian chấm điểm để nắm được thông tin tổng quan về tính năng này.

Giai đoạn chấm điểm mở rộng CourseWork bằng gradingPeriodId để xác định giai đoạn chấm điểm mà bài tập thuộc về.

Hãy xem hướng dẫn về API giai đoạn chấm điểm để tìm hiểu cách đọc và quản lý giai đoạn chấm điểm bằng API.

Tiêu chí chấm điểm

Giáo viên có thể tạo và liên kết Rubrics với bài tập CourseWork, đồng thời sử dụng các tiêu chí chấm điểm này làm hướng dẫn khi chấm điểm StudentSubmissions tương ứng.

Xem bài viết về tiêu chí chấm điểm để tìm hiểu cách giáo viên có thể sử dụng tiêu chí chấm điểm trong Lớp học.

Thang điểm mở rộng tài nguyên StudentSubmissions bằng các trường bổ sung:

• rubricId xác định thang điểm tương ứng với CourseWork của bài tập.
• draftRubricGrades biểu thị tiêu chí và điểm số giữ chỗ mà giáo viên đã soạn thảo trước khi trả bài nộp cho học viên.
• assignedRubricGrades là tiêu chí và điểm số mà học viên nhận được sau khi giáo viên trả bài nộp.

Hãy xem hướng dẫn về API bảng điểm để biết cách quản lý bảng điểm và đọc các điểm số liên quan bằng API.

Thang điểm

Lớp học hỗ trợ thang điểm có thể tuỳ chỉnh, ví dụ: cho phép giáo viên chuyển điểm số thành điểm chữ. Các chế độ cài đặt này và dữ liệu tương ứng không có trong API.