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 Phiếu chấm điểm của Lớp học, hãy xem các bài viết này trên Trung tâm trợ giúp để tìm hiểu về cấu trúc chung của phiếu chấm điểm và cách chấm điểm bằng phiếu 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

Có một số khái niệm quan trọng mà bạn nên lưu ý khi sử dụng API để tương tác với bảng điểm:

  • Có (tối đa) một rubric được liên kết với một CourseWork và tiêu chí chấm điểm đó là duy nhất đối với CourseWork đó (không thể chia sẻ trên các tài nguyên CourseWork).
  • Rubric bao gồm tiêu chí, trong đó có các cấp độ. Thang điểm phải luôn có ít nhất một tiêu chí và tiêu chí phải luôn có ít nhất một cấp độ.
  • Các cấp độ có thể được chấm điểm (có điểm) hoặc không được chấm đ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 bảng đ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ị điểm duy nhất. Điểm có thể là số nguyên (chẳng hạn như 10) hoặc giá trị dấu phẩy động (chẳng hạn như 9,99). Giá trị này có thể là 0. Giá trị rỗng không được chấp nhận. Ngoài ra, một thang điểm không thể 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; hệ thống không chấp nhận giá trị rỗng.
  • Thứ tự của tiêu chí và cấp độ có ý nghĩa và phản ánh thứ tự mà chúng được thể hiện trong giao diện người dùng Lớp học.
    • Cụ thể, các cấp độ được tính điểm 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 bảng điểm 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 StudentSubmission hỗ trợ các trường liên quan đến bảng điểm:

  • Ngoài các thuộc tính draftGrade và assignedGrade hiện có, bài tập mà học viên gửi đã được chấm điểm bằng một bảng điểm có các thuộc tính draftRubricGrades và assignedRubricGrades. Đây là điểm theo thang đ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 theo thang điểm, tương ứng ở trạng thái bản nháp và đã giao.
  • Hiện tại, bạn chỉ có quyền chỉ đọc đối với các tài sản này. Đ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, nhưng bạn có thể đọc bài tập đã chấm điểm trong giao diện người dùng Lớp học.

Hành vi của 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 mà nhà phát triển có thể không hiểu rõ và đáng được đề cập:

  • Phiếu chấm điểm nhằm hướng dẫn việc chấm điểm mà không hạn chế 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 tập bằng một bảng điểm:
    • 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ọ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 cấp độ tương ứng.
    • Ghi đè tổng điểm của bài tập, bất kể điểm đến từ bảng đ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 này không cho phép thực thi việc sử dụng bảng điểm trên bài tập hoặc ghi đè khả năng chỉnh sửa bảng điểm và bài tập của giáo viên như hiện nay.

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

Tương tự, có một số hạn chế bổ sung đố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 bằng tiêu chí đó. Bạn chỉ có thể chỉnh sửa những nội dung sau đây sau khi bắt đầu phân loại:

  • 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 phạm vi tiêu chí.

Các phạm vi bổ sung

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

Nếu bạn tạo hoặc cập nhật một bảng đ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 các 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 thang điểm. Đây là một mẫu thiết kế rộng hơn trong Classroom API, giúp ngăn các ứng dụng khác nhau ảnh hưởng đến những tài nguyên không phải của chúng.

Điều này áp dụng cho cả những tài nguyên do người dùng tạo trong ứng dụng Lớp học. Ví dụ: Ứng dụng không thể quản lý tiêu chí chấm điểm cho một 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 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á bảng điểm bằng Classroom API nếu đáp ứng các điều kiện sau:

Hãy xem điều kiện để người dùng đủ điều kiện để tìm hiểu thêm về cách các chức năng của API được cung cấp cho người dùng và đ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ạ cho mục đích phát triển.

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