Tích hợp CourseWork

Nhà phát triển có thể sử dụng API Google Lớp học để tương tác với bài tập trong Google Lớp học. Ứng dụng sử dụng API theo cách này được gọi là tích hợp CourseWork.

Đường dẫn tích hợp này thường được dùng để tạo và chấm điểm bài tập có đường liên kết đến tài nguyên bên ngoài Lớp học. Dịch vụ này cấp nhiều quyền truy cập hơn cho nhà phát triển vào việc quản lý tài liệu môn học so với các nút Chia sẻ trong Lớp học.

Cách hoạt động

Tính năng cốt lõi của việc tích hợp CourseWork là tạo và quản lý bài tập, thông báo và tài liệu khoá học bằng API Lớp học.

Một ví dụ về hành trình phổ biến của người dùng được tích hợp CourseWork là cho phép giáo viên khám phá, giao và chấm điểm nội dung ngay trong trang web hoặc ứng dụng của bạn:

1. Một người dùng là giáo viên đăng nhập vào trang web của bạn.
2. Giáo viên sẽ tìm hoặc tạo nội dung mà các em muốn chia sẻ với lớp của mình. Giáo viên nhấp vào một nút trên trang web của bạn để gửi nội dung này đến Google Lớp học.
3. Ứng dụng của bạn gửi yêu cầu đến courses.courseWork.create. Yêu cầu chứa một đối tượng CourseWork trong phần nội dung chứa:
   • Mã khoá học đích.
   • Tiêu đề của bài tập.
   • Nội dung mô tả bằng văn bản cho bài tập.
   • link Material có URL đến nội dung do giáo viên chọn.
   • Điểm số tối đa có thể đạt được cho nội dung đã chọn (không bắt buộc).
4. Một bài tập mới sẽ xuất hiện trong Lớp học cùng với một tệp đính kèm đường liên kết. Đường liên kết này tham chiếu đến URL được chỉ định trong yêu cầu create. Hãy xem Hình 1 để biết ví dụ.
5. Một cột mới cho bài tập cũng sẽ xuất hiện trong sổ điểm của lớp học, bao gồm cả điểm tối đa nếu bạn cung cấp.
6. Học viên nhận được bài tập và nhấp vào link Material để mở URL được cung cấp trong một thẻ mới, sau đó xem hoặc hoàn thành nội dung trên trang web của bạn. Bạn có thể cung cấp các chế độ kiểm soát để học viên nộp bài tập (không bắt buộc).
7. Bạn có thể đưa ra yêu cầu cho courses.courseWork.studentSubmissions.modifyAttachments để thêm tệp đính kèm vào bài tập mà học viên nộp, chẳng hạn như tệp trên Google Drive hoặc link Material trỏ đến bài tập của học viên trên trang web của bạn.
8. Bạn có thể đưa ra yêu cầu cho courses.courseWork.studentSubmissions.patch để đặt điểm cho bài tập của học viên.

Hình 1. Chế độ xem của giáo viên khi chỉnh sửa bài tập có link Material do một công cụ tích hợp CourseWork tạo.

Ngoài ra, bạn có thể gọi courses.announcements.create hoặc courses.courseWorkMaterials.create để tạo thông báo hoặc tài liệu về khoá học thay vì bài tập. Hãy xem các trang Tạo và quản lý bài tập và Đặt và cập nhật điểm để biết nội dung mô tả chi tiết về các thao tác liên quan của API Lớp học.

Những yếu tố nên cân nhắc

Hãy lưu ý những điều sau đây trước khi quyết định xem việc tích hợp CourseWork có phải là lựa chọn phù hợp với nhu cầu sản phẩm của bạn hay không.

• Bạn cần cho phép người dùng và nhắc họ đồng ý. Bạn đang thực hiện các yêu cầu API thay mặt cho người dùng. Ví dụ: điều này có nghĩa là bạn không thể tạo bài tập trong bất kỳ khoá học nào trên Google Lớp học; bạn chỉ có thể tạo bài tập trong các khoá học mà người dùng được uỷ quyền giảng dạy.
• Bạn cần có cách để người dùng chọn một khoá học để nhận nội dung. Hãy cân nhắc sử dụng courses.list để lấy danh sách các khoá học do người dùng giảng dạy, sau đó cho phép người dùng chọn một hoặc nhiều khoá học trong danh sách.
• Khi người dùng nhấp vào link Material trong Lớp học, đường liên kết sẽ mở trong một thẻ mới. Máy chủ của bạn sẽ không nhận được bất kỳ thông tin nào từ Lớp học khi URL mở ra.
• Giáo viên có thể sửa đổi hoặc xoá bài tập độc lập với nhà phát triển. Điều này có nghĩa là kiến thức của nhà phát triển về khoá học có thể đã lỗi thời. Nếu bạn cần nắm bắt các thay đổi trong bài tập, hãy cân nhắc thiết lập thông báo đẩy về các thay đổi trong bài tập.
• Giáo viên có thể tạo bài tập trong giao diện người dùng Lớp học bằng cách dán đường liên kết đến URL trên trang web của bạn. Bài tập được tạo theo cách này chỉ thuộc quyền sở hữu của giáo viên, vì vậy, bạn sẽ không thể xem, sửa đổi hoặc đặt điểm bài nộp bằng API Lớp học.