Điểm

Tài liệu này giới thiệu các khái niệm chấm điểm có liên quan đến API Lớp học.

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

Bài tập và bài nộp

Trong Google Lớp học, học viên nộp StudentSubmissions cho bài tập CourseWork trong Course của họ. 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 thể hiện tổng điểm của bài tập. Nếu maxPoints là 0 hoặc chưa được chỉ định, thì bài tập sẽ không được chấm điểm.

Đối với các bài tập đã chấm điểm, giáo viên sẽ đặt điểm draftGrade trên StudentSubmission trước khi trả bài tập cho học viên. Khi nội dung gửi được trả về 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ể đặt 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ụ: không thể đặt assignedGrade nếu không có draftGrade. Cả hai trường này đều được biểu thị bằng số thập phân và nếu không được đặt, thì có nghĩa là giáo viên chưa đặt điểm tương ứng. Xem bài viết tạo và quản lý điểm để tham khảo các đoạn mã ví dụ về cách đọc, đặt và trả điểm.

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

Bài tập nộp muộn, bài tập nộp trễ vì lý do chính đáng và bài tập bị thiếu

Khi các mục CourseWork được chỉ định, phần giữ chỗ StudentSubmissions sẽ được tạo cho mỗi 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 một dueDate trên CourseWork và StudentSubmissions liên kết sẽ được đánh dấu bằng trường late (được đặ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, StudentSubmissions không được gửi trước dueDate sẽ được chú thích trong sổ điểm Lớp học là bị thiếu. Giáo viên cũng có thể tự đánh dấu bài nộp là còn thiếu trong ứng dụng Lớp học. Những bài tập còn thiếu sẽ tự động được cấp draftGrade. Giáo viên có thể tuỳ chỉnh giá trị này nhưng giá trị mặc định là 0.

Giáo viên có thể đánh dấu bài nộp bị thiếu là đã hoàn thành hoặc được miễn. StudentSubmissions được đánh dấu là hoàn thành sẽ xoá trường draftGrade mặc định cho đến khi giáo viên đặ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 quá trình tính điểm tổng thể, bao gồm cả khoảng thời gian chấm điểm.

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

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

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

Hãy xem bài viết thiết lập tính năng chấm điểm để tìm hiểu về các hệ thống chấm điểm cùng ví dụ.

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

• Tài nguyên Course có đối tượng gradebookSettings chứa thông tin chi tiết về chế độ cài đặt điểm 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ủ điều này trong ứng dụng của mình khi 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, đừng hiện điểm trong ứng dụng của bạn.
  • gradeCategories chứa danh sách các danh mục điểm được định cấu hình cho khoá học, bao gồm 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ố, thì bạn có thể cần chuẩn hoá các trọng số trong những trường hợp không có danh mục. Ví dụ: nếu trọng số của 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 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 dự định phản ánh điểm tổng thể của Lớp học trong ứng dụng, bạn cần làm tương tự.

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

Giáo viên có thể nhóm các bài tập CourseWork trong một khoá học thành các khoảng ngày 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 tổng điểm.

Ví dụ: giáo viên có thể tạo các giai đoạn chấm điểm học kỳ "xuân" và "thu". Điểm tổng thể 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 đặt 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 đặt trên một khoá học sử dụng các danh mục chấm điểm có trọng số, thì cuối cùng, học viên sẽ có 3 bộ tổng điểm:

• Tổng điểm của tất cả bài tập trong khoá học.
• Điểm tổng thể của tất cả bài tập trong khoảng thời gian mùa xuân.
• Tổng điểm của tất cả bài tập trong phạm vi ngày mùa thu.

Cả ba đều tính tổng điểm theo các 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ý các 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.

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

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

• rubricId xác định điểm đánh giá tương ứng với CourseWork của bài nộp.
• draftRubricGrades đại diện cho tiêu chí và điểm giữ chỗ mà giáo viên đã soạn trước khi trả bài nộp cho học viên.
• assignedRubricGrades đại diện cho các tiêu chí và điểm 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 tiêu chí để biết cách quản lý tiêu chí và đọc điểm liên quan bằng API.

Thang điểm

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