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 hiểu rõ về Tiêu chí chấm điểm trong 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 tiêu chí chấm điểm và cách chấm điểm dựa trên tiêu chí chấm đ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

Bạn nên nêu bật một số khái niệm quan trọng 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 tiêu chí chấm điểm liên kết với một CourseWork và tiêu chí chấm điểm đó là duy nhất cho CourseWork đó (không thể chia sẻ trên các tài nguyên của CourseWork).
  • Tiêu chí chấm điểm bao gồm tiêu chí, bao gồm cấp độ. Tiêu chí chấm đ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ấp có thể được tính điểm (có điểm) hoặc chưa có điểm (không có điểm). Các cấp phải được chấm hoàn toàn hoặc không có điểm trong tiêu chí chấm điểm.
    • Nếu các cấp được tính điểm, tất cả các cấp trong một tiêu chí phải có một bộ 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ể bao gồm 0. Không chấp nhận giá trị rỗng. Ngoài ra, tiêu chí chấm điểm không được có một tiêu chí duy nhất có một cấp độ là 0 điểm.
    • Nếu các cấp không có điểm, trường điểm sẽ bị bỏ qua; giá trị rỗng không được chấp nhận.
  • Thứ tự của các tiêu chí và cấp độ có ý nghĩa, phản ánh thứ tự thể hiện 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 độ theo điểm phải luôn được sắp xếp theo thứ tự tăng hoặc giảm.
  • Có thể có tối đa 50 tiêu chí chấm điểm và tối đa 10 mức hiệu suất cho mỗi tiêu chí.

Các đối tượng bài nộp của học viên 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 tiêu chí chấm điểm còn có các thuộc tính draftRubricGrades và assignedRubricGrades. Các điểm này thể hiện điểm theo tiêu chí chấm điểm (cấp đã chọn và giá trị điểm) mà học viên nhận được trong quá trình chấm điểm từ tiêu chí chấm điểm, ở trạng thái bản nháp và trạng thái được giao.
  • Hiện tại, các thuộc tính này đang ở chế độ chỉ đọc. Điều này có nghĩa là bạn không thể sử dụng API để chấm điểm bài nộp, nhưng bạn có thể đọc các bài nộp đã được chấm điểm trong giao diện người dùng Lớp học.
  • Bài tập mà học viên nộp có tiêu chí chấm điểm liên kết sẽ có trường rubricId. Trường này đại diện cho tiêu chí chấm điểm mới nhất 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 tiêu chí chấm điểm.

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

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

  • Mục đích của tiêu chí chấm điểm là để hướng dẫn việc chấm điểm mà không gây hạn chế cho giáo viên. Do đó, giáo viên có thể làm những việc sau khi chấm điểm bài nộ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 hiện có trong các cấp của tiêu chí đó.
    • Chỉ chọn cấp độ cho một số ít tiêu chí.
    • Gán điểm cho một tiêu chí mà không cần chọn cấp tương ứng.
    • Ghi đè tổng điểm của bài tập, bất kể số điểm đến từ tiêu chí chấm điểm.

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

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

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

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

Các phạm vi bổ sung

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

Nếu bạn tạo hoặc cập nhật tiêu chí chấm điểm qua 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. Xin lưu ý rằng phạm vi spreadsheets được coi là nhạy cảm và có thể yêu cầu bạn xác minh ứng dụng.