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 Lớp học, hãy xem các bài viết này 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 tiêu chí chấm điểm trong giao diện người dùng 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 bạn có thể cần nêu bật khi sử dụng API để tương tác với tiêu chí chấm điểm:

  • Có (tối đa) một tiêu chí chấm điểm được liên kết với CourseWork và tiêu chí chấm điểm là duy nhất cho CourseWork đó (không thể chia sẻ qua CourseWork).
  • Tiêu chí chấm điểm bao gồm các tiêu chí, bao gồm các 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ác cấp có thể được tính điểm (có điểm) hoặc không được tính điểm (không có điểm). Cấp độ phải là được chấm điểm hoàn toàn 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ó một giá trị duy nhất đã thiết lập giá trị điểm. Điểm có thể là số nguyên (chẳng hạn như 10) hoặc dấu phẩy động (như 9,99). Số liệu 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 thể có một tiêu chí duy nhất với một mức độ duy nhất tức là 0 điểm.
    • Nếu các cấp độ không được tính điểm, thì trường điểm sẽ bị bỏ qua; rỗng không được chấp nhận.
  • 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 độ đó được thể hiện trong giao diện người dùng Lớp học.
    • Phải luôn sắp xếp các cấp được tính điểm cụ thể theo điểm trong thứ tự tăng hoặc giảm.
  • Có thể có tối đa 50 tiêu chí cho mỗi tiêu chí chấm điểm và tối đa 10 mức hiệu suất theo tiêu chí.

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

  • Ngoài các tài sản draftGrade và assignedGrade hiện có, một bài tập mà học viên nộp được chấm điểm theo tiêu chí chấm điểm, có draftRubricGrades và Tài sản assignedRubricGrades. Các cấp độ này thể hiện điểm theo tiêu chí chấm điểm (cấp độ đã chọn và đ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 chỉ định tương ứng.
  • 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à API không thể dùng để chấm điểm bài tập đã nộp, nhưng bạn có thể đọc bài tập đã 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 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

API này hướng đến việc phản chiếu 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 điều này có thể dẫn đến hành vi khó hiểu đối với nhà phát triển và đề cập đến:

  • Tiêu chí chấm điểm là nhằm hướng dẫn cách chấm điểm mà không ràng buộc giáo viên. Là một kết quả, giáo viên có thể thực hiện như sau khi chấm điểm một 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 tiêu chí, bất kể điểm có sẵn ở các cấp của tiêu chí.
    • Chỉ chọn các cấp cho một nhóm nhỏ tiêu chí.
    • Chỉ định điểm cho một tiêu chí mà không chọn cấp độ 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 sẽ không ra mắt bất kỳ tính năng mới nào về sản phẩm. Trong khu vực khác hơn, 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 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 tập đã nộp của giáo viên một cách tối ưu ngay hôm nay.

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

Tương tự, cũng có một số giới hạn khác khi chỉnh sửa tiêu chí chấm điểm sau khi giáo viên đã bắt đầu chấm điểm bằng công cụ này. Chỉ có thể chỉnh sửa các sau đây sau khi chấm điểm ban đầu:

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

Các phạm vi khác

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

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