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. API này cung cấp cho nhà phát triển nhiều quyền truy cập hơn vào việc quản lý bài tập so với 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:
- Một người dùng là giáo viên đăng nhập vào trang web của bạn.
- Giáo viên tìm hoặc tạo nội dung mà họ muốn chia sẻ với lớp học. 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.
- Ứng dụng của bạn đưa ra yêu cầu cho
courses.courseWork.create. Yêu cầu chứa một đối tượngCourseWorktrong 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.
linkMaterialcó 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).
- 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 là đườ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ụ. - 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 số tối đa nếu bạn cung cấp.
- 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). - 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ặclink Materialtrỏ đến bài tập của học viên trên trang web của bạn. - 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 uỷ quyền cho 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 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 Materialtrong 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 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.