Giới thiệu

Bài tập trong Lớp học được gọi là mục Bài tập trên lớp. Bạn có thể tìm thấy các mục này trên trang Bài tập trên lớp của một khoá học bất kỳ trong Lớp học. Mặc dù có 4 loại mục Bài tập trên lớp, nhưng hướng dẫn này chỉ tập trung vào loại "Bài tập". Nếu bạn muốn tìm hiểu về cách quản lý các loại Bài tập trên lớp khác, hãy đọc hướng dẫn Quản lý bài tập trên lớp.

Google Lớp học có hai cách để tích hợp với quy trình làm bài tập: Nút chia sẻ của Lớp họcAPI Lớp học. Nút chia sẻ cho phép người dùng chia sẻ nội dung dưới dạng bất kỳ mục nào trong luồng thông qua hộp thoại bật lên của Lớp học, trong khi API Lớp học cho phép quy trình giao bài tập từ đầu đến cuối, bao gồm cả việc tạo bài tập, tạo và quản lý bài nộp của học viên cũng như trả lại điểm.

Tại đây, chúng ta sẽ xem xét những điểm khác biệt chính giữa hai sản phẩm dành cho nhà phát triển này. Cụ thể hơn, chúng ta sẽ tìm hiểu những điểm khác biệt trong quá trình triển khai và từng giai đoạn của vòng đời bài tập: tạo bài tập, học viên gửi bài và chấm điểm/phản hồi.

Tìm hiểu vòng đời của bài tập

Trước khi chuyển sang phần trình bày sự khác biệt giữa nút chia sẻ và CourseWork API, trước tiên, hãy xác định vòng đời của bài tập trong bối cảnh của Lớp học. Nhờ đó, bạn sẽ hiểu được cách giáo viên và học viên tương tác với bài tập trong Lớp học.

5 bước chính cần lưu ý khi tích hợp với bài tập trên Lớp học:

  1. Đã tạo bài tập.
  2. Bài tập được chia sẻ với học viên.
  3. Học viên hoàn thành bài tập.
  4. Học viên nộp bài tập cho giáo viên.
  5. Giáo viên xem xét và chấm điểm bài tập.

Việc tích hợp với bài tập trong Lớp học giúp giáo viên và học viên làm việc liền mạch giữa Lớp học và các ứng dụng bên thứ ba. Thay vì quản lý thông tin chi tiết về bài tập hoặc bài tập đã nộp của học viên, người dùng có thể dựa vào ứng dụng của bạn để quản lý những thông tin chi tiết này cho họ.

Sơ đồ minh hoạ 5 bước để hoàn thành bài tập

Triển khai

Điểm khác biệt đầu tiên giữa nút chia sẻ và CourseWork API là cách triển khai. Theo quan điểm của nhà phát triển, nút chia sẻ là một phương thức dễ dàng hơn để chia sẻ nội dung lên Lớp học vì phương thức này chỉ yêu cầu bạn thêm tài nguyên JavaScript cần thiết và thêm thẻ nút chia sẻ. Ở dạng đơn giản nhất, chế độ tích hợp nút chia sẻ của Lớp học có thể trông giống như đoạn mã bên dưới:

<script src="https://apis.google.com/js/platform.js" async defer></script>
<g:sharetoclassroom url="http://url-to-share" size="32"></g:sharetoclassroom>

Mặt khác, CourseWork API là một phần của Google Classroom API REST API. API này yêu cầu bạn thiết lập và bật khoá API bằng Google Cloud Console, đồng thời tuân theo các phương pháp hay nhất để tích hợp với một API. Đây không phải là vấn đề đáng lo ngại nếu nền tảng của bạn đã tận dụng các chức năng khác của API Lớp học, chẳng hạn như lập danh sách.

Tạo và chia sẻ bài tập

Mặc dù cả nút chia sẻ và CourseWork API đều hỗ trợ 2 bước đầu tiên của quy trình giao bài tập (tạo và chia sẻ bài tập với học viên), nhưng có một số điểm khác biệt quan trọng mà bạn nên cân nhắc trước khi chọn một giải pháp.

Về cơ bản, cả hai giải pháp này đều cho phép đăng đường liên kết hoặc tệp dưới dạng bài tập trên Lớp học. Đây là một quy trình làm việc hiệu quả cho những giáo viên nếu không sẽ buộc phải thực hiện quy trình sao chép và dán giữa Lớp học và ứng dụng bên thứ ba. Mặc dù cả hai giải pháp đều hỗ trợ khả năng đăng nội dung dưới dạng bài tập, nhưng bạn nên cân nhắc xem ứng dụng của mình có cần tính linh hoạt để đăng nội dung này dưới dạng các loại Bài tập trên lớp khác hay thậm chí là thông báo hay không.

Cả hai sản phẩm này đều hiển thị tất cả các loại bài đăng trong Lớp học, ngoại trừ Bài tập dạng bài kiểm tra. Bạn có thể xem tóm tắt về tất cả các loại bài đăng và liệu chúng có được hiển thị hay không ở bên dưới.

Loại bài đăng Nút chia sẻ CourseWork API
Assignment X X
Bài kiểm tra
Câu hỏi: Câu trả lời ngắn X X
Câu hỏi: Trắc nghiệm X X
Chất liệu X X
Thông báo X X

Ứng dụng của bạn cũng có thể chỉ định theo chương trình các chức năng như chỉ định tiêu đề và nội dung mô tả cho cả hai giải pháp. Mặc dù chế độ tích hợp nút chia sẻ cho phép người dùng đặt các trường như ngày đến hạn, chủ đề, chế độ riêng lẻ và số điểm trong hộp thoại bật lên, nhưng ứng dụng bên thứ ba không thể đặt các trường này theo phương thức lập trình. Mặt khác, API này cung cấp tất cả các trường này cho cả quyền truy cập đọc và ghi.

Sửa đổi bài tập

Một trong những lợi ích của việc tích hợp với API Lớp học là người dùng không cần phải đồng bộ hoá thủ công các thông tin thay đổi về bài tập. Nút chia sẻ không có chức năng cập nhật hoặc xoá bài tập theo cách lập trình, vì vậy, người dùng sẽ phải thực hiện mọi nội dung sửa đổi cần thiết thông qua giao diện người dùng của Lớp học.

CourseWork API cho phép cả khả năng sửa đổi và xoá bài tập mà ứng dụng của bạn đã tạo, cũng như khả năng truy xuất thông tin chi tiết về mọi bài tập được đăng trong các khoá học của người dùng. Tuy nhiên, bạn cần lưu ý rằng các mục Bài tập trên lớp không do cùng một bảng điều khiển dành cho nhà phát triển tạo ra thì không thể được bảng điều khiển dành cho nhà phát triển đó sửa đổi. Mô hình quyền này mở rộng sang phần còn lại của vòng đời bài tập, chẳng hạn như việc quản lý bài nộp và điểm của học viên, không thể truy cập vào các mục Bài tập trên lớp này.

Tự động đồng bộ hoá bài tập

Với thông báo đẩy Pub/Sub, ứng dụng của bạn có thể đăng ký nhận thông báo kích hoạt một sự kiện khi có thay đổi về các mục CourseWork và bài tập đã gửi của học viên được liên kết. Điều này cho phép ứng dụng của bạn dễ dàng đồng bộ hoá bài tập bằng cách loại bỏ nhu cầu kiểm tra liên tục để xem nội dung có được cập nhật trên Lớp học hay không.

Hoàn thành và nộp bài tập

Mỗi bài tập được liên kết với N bài nộp của học viên, trong đó N là số học viên được giao bài tập. Nói cách khác, đối với mỗi bài tập, sẽ có một bài nộp của học viên được liên kết với mỗi học viên. Bạn có thể truy cập vào bài nộp này bằng một mã nhận dạng duy nhất. Các bài tập đã nộp này của học viên được tạo tự động và ứng dụng của bạn có thể truy xuất bằng các điểm cuối GET và LIST của bài tập đã nộp của học viên.

Cả nút chia sẻ và CourseWork API đều hỗ trợ việc thêm đường liên kết hoặc tệp vào bài tập đã nộp của học viên. Nút chia sẻ cho phép thực hiện việc này thông qua quy trình tương tự như hộp thoại tạo bài tập của giáo viên và CourseWork API thông qua điểm cuối studentSubmissions.modifyAttachments. Tuy nhiên, do các quy định hạn chế về quyền truy cập API được nêu chi tiết trước đó, chức năng này chỉ giới hạn ở những mục CourseWork mà ứng dụng của bạn đã tạo. Tuy nhiên, nút chia sẻ không có hạn chế này. Học viên có thể thêm bài tập của mình vào bất kỳ bài tập nào mà họ chọn trong Lớp học.

Kết thúc quy trình dành cho học viên

Mặc dù chế độ hạn chế quyền CourseWork không phục vụ trường hợp sử dụng cho các nền tảng không hỗ trợ việc tạo bài tập, nhưng một lợi ích là các nền tảng bên thứ ba có thể ngăn học viên gửi bài tập không chính xác và quên nộp bài vì chỉ có nút chia sẻ bị hạn chế khả năng nộp bài tập của học viên.

Xem xét và chấm điểm bài tập

Phần cuối cùng của vòng đời bài tập sẽ quay lại với giáo viên. Sau khi học viên nộp bài tập thành công, giáo viên có thể xem xét bài tập theo cách phù hợp nhất. Đối với các tệp được lưu trữ trong Drive, học viên có thể xem lại ngay trong công cụ chấm điểm của Lớp học. Tuy nhiên, bạn không thể truy cập vào các ứng dụng bên thứ ba trong công cụ chấm điểm của Lớp học. Hệ quả của trải nghiệm này là giáo viên phải chuyển đổi giữa nhiều thẻ khi xem xét và chấm điểm bài tập.

Nút chia sẻ hiện không có giải pháp chấm điểm và trả bài tập. Mặc dù các tính năng như nhận xét về bài tập mà học viên đã nộp hiện không được hiển thị thông qua API, nhưng bạn có thể chấm điểm và trả điểm cho học viên thông qua các điểm cuối studentSubmissions.patchstudentSubmissions.return. Bạn chỉ có thể chỉ định điểm cho các mục trong luồng CourseWork (loại Bài tập và Câu hỏi). Điểm số chỉ có ở dạng số và có thể được chỉ định là điểm nháp hoặc điểm cuối cùng.

Tóm tắt sự khác biệt

Để tóm tắt mọi nội dung đã xem xét trong các phần trước, bảng dưới đây cho thấy sự so sánh song song giữa nút chia sẻ và CourseWork API cho 4 danh mục đã thảo luận ở trên: triển khai, tạo và chia sẻ bài tập, hoàn thành và gửi bài tập, cũng như xem xét và chấm điểm bài tập.

Nút chia sẻ CourseWork API
Triển khai Chỉ cần một vài dòng JavaScript, giúp việc triển khai trở nên đơn giản và nhanh chóng Yêu cầu thiết lập khoá API, bật API trong bảng điều khiển dành cho quản trị viên và theo dõi chặt chẽ hơn
Tạo và chia sẻ bài tập
  • Chuyển hướng giáo viên đến hộp thoại chia sẻ của nút chia sẻ trên Lớp học
  • Người dùng có thể đăng tất cả các loại mục trên luồng, ngoại trừ một loại
  • Bạn có thể chỉ định ít trường hơn
  • Một người có thể tạo bài tập, nhưng không thể lấy hoặc sửa đổi dữ liệu bài tập
  • Hộp thoại không cần nút chia sẻ
  • Bạn có thể chỉ định hầu hết các trường bài tập trên Lớp học
  • Có thể sửa đổi bài tập trên lớp do ứng dụng của bạn tạo
  • Cho phép ứng dụng của bạn lấy tất cả dữ liệu bài tập trên Lớp học
Hoàn thành và nộp bài tập
  • Chuyển hướng học viên đến hộp thoại chia sẻ của nút chia sẻ trên Lớp học
  • Cho phép học viên đính kèm bài nộp vào bất kỳ bài tập nào trên Lớp học
  • Một là cho phép gửi tệp đính kèm, không thể kéo hoặc sửa đổi dữ liệu của biểu mẫu
  • Không cho phép học viên nộp bài tập
  • Hộp thoại không cần nút chia sẻ
  • Chỉ cho phép học viên đính kèm bài nộp vào bài tập do ứng dụng của bạn tạo
  • Cho phép ứng dụng của bạn sửa đổi bài tập mà học viên đã nộp do ứng dụng của bạn tạo
  • Cho phép học viên nộp bài tập
Xem xét và chấm điểm bài tập Không hỗ trợ việc chỉ định hoặc trả về điểm
  • Cho phép ứng dụng của bạn thay mặt giáo viên lấy tất cả dữ liệu bài tập đã nộp của học viên trên Lớp học
  • Cho phép chỉ định điểm số cho học viên, dưới dạng điểm nháp hoặc điểm cuối cùng
  • Cho phép sửa đổi điểm của học viên
  • Cho phép trả điểm cho học viên