Cấu trúc tiêu chí chấm điểm và các hạn chế đã biết

Nếu bạn chưa quen với Bảng điểm của Lớp học, hãy xem các bài viết sau trong Trung tâm trợ giúp để tìm hiểu về cấu trúc chung của bảng điểm và cách chấm điểm theo bảng điểm trong giao diện người dùng của Lớp học.

Cấu trúc tiêu chí chấm điểm

Có một số khái niệm quan trọng mà bạn có thể cần nhấn mạnh khi sử dụng API để tương tác với các tiêu chí chấm điểm:

  • Có (tối đa) một bảng điểm được liên kết với một CourseWork và bảng điểm đó là duy nhất cho CourseWork đó (không thể chia sẻ trên các tài nguyên CourseWork).
  • Tiêu chí chấm điểm bao gồm các tiêu chí, bao gồm các cấp độ. Một thang điểm phải luôn có ít nhất một tiêu chí và một tiêu chí phải luôn có ít nhất một cấp.
  • Các cấp có thể được tính điểm (có điểm) hoặc không tính điểm (không có điểm). Các cấp phải được chấm điểm toàn bộ hoặc hoàn toàn không được tính điểm theo tiêu chí chấm điểm.
    • Nếu các cấp được tính điểm, thì tất cả các cấp trong một tiêu chí phải được đặt một giá trị điểm duy nhất. Điểm có thể là số nguyên (như 10) hoặc giá trị dấu phẩy động (như 9,99). Giá trị này có thể là 0. Không chấp nhận giá trị rỗng. Ngoài ra, một thang điểm không được có một tiêu chí duy nhất với một cấp độ duy nhất là 0 điểm.
    • Nếu các cấp không được tính điểm, bạn nên bỏ qua trường điểm; không chấp nhận giá trị rỗng.
  • Thứ tự của các tiêu chí và cấp độ có ý nghĩa và phản ánh thứ tự của các tiêu chí và cấp độ đó trong giao diện người dùng của Lớp học.
    • Cụ thể, các cấp độ có điểm số phải luôn được sắp xếp theo điểm theo thứ tự tăng dần hoặc giảm dần.
  • Mỗi tiêu chí có thể có tối đa 50 tiêu chí và mỗi tiêu chí có thể có tối đa 10 mức độ hiệu quả học tập.

Các đối tượng học viên nộp cũng sẽ thay đổi:

  • Ngoài các thuộc tính draftGrade và assignedGrade hiện có, bài nộp của học viên được chấm điểm theo thang điểm sẽ có các thuộc tính draftRubricGrades và assignedRubricGrades. Các giá trị này thể hiện điểm theo thang điểm (cấp độ được chọn và giá trị điểm) mà học viên nhận được trong quá trình chấm điểm theo thang điểm, tương ứng với trạng thái nháp và đã giao.
  • Hiện tại, các thuộc tính này ở chế độ chỉ có thể đọc. Điều này có nghĩa là bạn không thể dùng API này để chấm điểm bài tập đã nộp, nhưng bạn có thể đọc các bài tập đã được chấm điểm trong giao diện người dùng của Lớp học.
  • Bài tập mà học viên đã nộp theo tiêu chí chấm điểm liên kết sẽ chứa trường rubricId. Trường này thể hiện thang điểm mới nhất được liên kết với CourseWork và giá trị này có thể thay đổi nếu giáo viên xoá và tạo lại thang điểm.

Hành vi tiêu chí chấm điểm

API này nhằm phản ánh giao diện người dùng của Lớp học bất cứ khi nào có thể để đảm bảo tính nhất quán, nhưng điều này có thể dẫn đến hành vi không trực quan đối với nhà phát triển và đáng được đề cập:

  • Bảng điểm dùng để hướng dẫn việc chấm điểm mà không ràng buộc giáo viên. Do đó, giáo viên có thể thực hiện những việc sau khi chấm điểm bài tập bằng tiêu chí chấm điểm:
    • Hoàn toàn bỏ qua tiêu chí chấm điểm khi chấm điểm.
    • Ghi đè điểm cho một tiêu chí, bất kể số điểm có sẵn trong các cấp của tiêu chí.
    • Chỉ chọn cấp cho một số tiêu chí.
    • Chỉ định điểm cho một tiêu chí mà không chọn mức tương ứng.
    • Ghi đè tổng điểm của bài tập, bất kể điểm sẽ đến từ tiêu chí chấm điểm.

Ngoài ra, API này không giới thiệu bất kỳ tính năng sản phẩm mới nào. Nói cách khác, API không hỗ trợ hành vi mà giao diện người dùng Lớp học chưa có. Ví dụ: API không cho phép thực thi việc sử dụng tiêu chí chấm điểm cho bài tập hoặc ghi đè khả năng của giáo viên trong việc chỉnh sửa tiêu chí chấm điểm và bài nộp như hiện tại.

Các hạn chế trong quá trình chấm điểm

Tương tự, cũng có một số hạn chế khác đối với việc chỉnh sửa tiêu chí chấm điểm sau khi giáo viên bắt đầu chấm điểm. Sau khi bắt đầu chấm điểm, bạn chỉ có thể chỉnh sửa những nội dung sau:

  • Bạn được phép chỉnh sửa văn bản cho tiêu đề và nội dung mô tả của tiêu chí và cấp.
  • Thứ tự cấp có thể thay đổi trong tiêu chí.

Phạm vi bổ sung

Bạn có thể xuất tiêu chí chấm điểm sang Google Trang tính theo cách thủ công để giáo viên sử dụng lại.

Nếu bạn tạo hoặc cập nhật một thang điểm từ các bảng tính này (xem ví dụ trong hướng dẫn), thì ứng dụng của bạn cần yêu cầu phạm vi https://www.googleapis.com/auth/spreadsheets.readonly hoặc https://www.googleapis.com/auth/spreadsheets. Hãy lưu ý rằng các phạm vi spreadsheets được xem là nhạy cảm và có thể yêu cầu ứng dụng của bạn phải được xác minh.

Trước
Giai đoạn chấm điểm