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 nên làm nổi bật khi sử dụng API để tương tác với thang đ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).
  • Bảng điểm bao gồm các tiêu chí, trong đó có 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 hoàn toàn hoặc không được chấm điểm hoàn toàn trong một thang đ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 tập hợp 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ự mà các tiêu chí và cấp độ đó được trình bày 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.

Đối tượng StudentSubmission hỗ trợ các trường liên quan đến thang điểm:

  • 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ỉ có thể đọ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 bài nộp đã được chấm điểm trong giao diện người dùng của Lớp học.

Hành vi của 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ể làm như sau khi chấm điểm bài nộp bằng một tiêu chí:
    • Bỏ qua hoàn toàn tiêu chí chấm điểm khi chấm điểm.
    • Ghi đè điểm cho một tiêu chí, bất kể đ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ừ thang điểm.

Ngoài ra, API này 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 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ó một số hạn chế khác về 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 bằng tiêu chí đó. 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. Xin lưu ý rằng phạm vi spreadsheets được coi 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.

Bài tập của bên thứ ba

Chỉ dự án Google Cloud đã tạo mục CourseWork mẹ mới có thể tạo tiêu chí. Đây là một mẫu thiết kế rộng hơn trong API Lớp học, giúp ngăn các ứng dụng khác nhau ảnh hưởng đến các tài nguyên không phải của chúng.

Điều này cũng áp dụng cho các tài nguyên do người dùng tạo trong ứng dụng Lớp học. Ví dụ: Một ứng dụng không thể quản lý tiêu chí chấm điểm cho bài tập mà giáo viên tạo trong giao diện người dùng Lớp học, ngay cả khi chính giáo viên đó sở hữu ứng dụng. Nếu điều này hạn chế đáng kể trường hợp sử dụng của bạn, hãy chia sẻ ý kiến phản hồi trong công cụ theo dõi lỗi công khai.

Yêu cầu về giấy phép

Người dùng chỉ có thể tạo, cập nhật và xoá tiêu chí đánh giá bằng API Lớp học nếu đáp ứng các điều kiện sau:

Hãy xem phần điều kiện sử dụng của người dùng để tìm hiểu thêm về cách hiển thị các tính năng của API cho người dùng và các điều kiện tiên quyết của API Lớp học để làm quen và yêu cầu tài khoản minh hoạ để phát triển.

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