Khả năng tương tác của công cụ học tập (LTI) là một khung mở để tạo các chế độ tích hợp của bên thứ ba trong hệ thống quản lý học tập. Mặc dù tiện ích bổ sung Lớp học và công cụ LTI hỗ trợ hành trình tương tự của người dùng, nhưng hai khung này không tương thích trực tiếp với nhau. Hướng dẫn này so sánh hai loại tích hợp và nêu bật những điểm khác biệt chính. Tài liệu này cũng đề xuất những cách để đạt được hành trình tương tự của người dùng khi điều chỉnh một công cụ LTI để hoạt động như một tiện ích bổ sung của Lớp học.
Tương tác giữa nền tảng và công cụ
Điểm khác biệt chính giữa công cụ LTI và tiện ích bổ sung của Lớp học là cách trao đổi thông tin. Các công cụ LTI thường sử dụng HTTP POST để truyền tải trọng đến một nền tảng LTI, trong khi các tiện ích bổ sung Google Lớp học tạo và truy xuất tài nguyên bằng API REST của Google Lớp học.
Bảng sau đây tóm tắt cách đạt được các hành vi chính của công cụ LTI bằng Google Lớp học.
| Tính năng | LTI | Lớp học |
|---|---|---|
| Tạo bài tập | Dịch vụ bài tập và điểm số | Tạo tài nguyên CourseWork và AddOnAttachment |
| Đăng điểm | Dịch vụ bài tập và điểm số | Chấm điểm CourseWork và AddOnAttachment bài tập đã nộp của học viên |
| Tuyến đường ra mắt | Liên kết sâu | Chỉ định URI trong tài nguyên AddOnAttachment |
| Đọc danh sách học viên của khoá học | Dịch vụ cung cấp tên và vai trò | Truy xuất hồ sơ Student và Teacher trong một khoá học |
Điều chỉnh công cụ LTI thành tiện ích bổ sung của Lớp học
Nhiều hoạt động tương tác LTI có các hoạt động tương tự trong khung tiện ích bổ sung của Lớp học. Các phần sau đây thảo luận về một số khái niệm chính và các bước hành động được đề xuất.
Định cấu hình ứng dụng
Tất cả các hoạt động tương tác theo chương trình với Google Lớp học đều yêu cầu một dự án trên Google Cloud. Bạn sẽ định cấu hình trang thông tin ứng dụng trong cùng một dự án trên đám mây. Dự án này xác định cách tiện ích bổ sung Classroom sẽ xuất hiện với người dùng cuối. Bạn sẽ cung cấp biểu tượng, đặt tên và nội dung mô tả cho ứng dụng, đồng thời định cấu hình các quyền trong phạm vi OAuth mà sản phẩm của bạn yêu cầu.
Cài đặt ứng dụng bổ trợ từ trang thông tin thường là bước thiết lập duy nhất mà người dùng cuối phải thực hiện. Việc này tương tự như việc bật và triển khai một công cụ LTI. Người dùng cuối sẽ không cần hoàn tất bất kỳ thao tác đăng ký nào hoặc quản lý bất kỳ thông tin chi tiết nào về cấu hình, mặc dù quản trị viên có thể cần phải cho phép ứng dụng trong Marketplace và thiết lập quyền truy cập dữ liệu của bên thứ ba.
Đề xuất: Làm theo hướng dẫn của chúng tôi để tạo và định cấu hình một dự án trên đám mây của Google cho tiện ích bổ sung Lớp học. Quan trọng nhất là hãy chỉ định một URL để chạy tiện ích bổ sung làm URI Khám phá tệp đính kèm trong Bộ công cụ phát triển phần mềm Thị trường. URL này có thể giống với một tuyến khởi chạy công cụ LTI hiện có, miễn là URL đó định tuyến người dùng đến quy trình xác thực thích hợp.
Quy trình xác thực
LTI sử dụng luồng 2 chân, trong đó ứng dụng khách và máy chủ xác thực trao đổi JWT đã ký. Người dùng không cần cấp cho công cụ quyền truy cập vào dữ liệu của họ, vì sự đồng ý được ngầm hiểu khi quản trị viên định cấu hình công cụ.
Ngược lại, quy trình OAuth của Google là một quy trình 3 chân, liên quan đến người dùng cuối, ứng dụng khách bên ngoài và máy chủ xác thực. Ứng dụng khách nhận được mã thông báo có sự đồng ý rõ ràng của người dùng, cho phép truy cập vào các tài nguyên Google Lớp học của người dùng.
Ứng dụng tiện ích bổ sung có thể đạt được hành vi tương tự của JWT đã ký 2 chân bằng cách sử dụng tài khoản dịch vụ. Đây là những tài khoản thuộc về một ứng dụng chứ không phải thuộc về một người dùng cá nhân và có thể thực hiện hành động mà không cần có sự đồng ý của người dùng. Bạn phải có quyền quản trị viên để sử dụng tài khoản dịch vụ. Bạn không nên sử dụng tài khoản dịch vụ có uỷ quyền trên toàn miền vì đây là những vectơ có khả năng bị lợi dụng. Hãy xem hướng dẫn của chúng tôi về uỷ quyền trên toàn miền bằng các chế độ tích hợp Google Lớp học để biết thêm thông tin chi tiết.
Đề xuất: Khi một URL liên kết với công cụ hoặc tiện ích bổ sung của bạn nhận được một yêu cầu đến, hãy kiểm tra yêu cầu để biết sự hiện diện của tham số truy vấn tiện ích bổ sung Lớp học. Nếu có, hãy sử dụng Google Identity SDK để lấy thông tin đăng nhập truy cập cho người dùng. Lưu trữ thông tin đăng nhập trong phiên của người dùng và sử dụng thông tin đăng nhập đó để thực hiện các yêu cầu tiếp theo đối với API Lớp học. Nếu không có tham số truy vấn, hãy sử dụng yêu cầu HTTP để tương tác với các điểm cuối LTI của nền tảng.
Tạo nội dung tiện ích bổ sung trong Google Lớp học
Tiện ích bổ sung cho Lớp học hỗ trợ một loại nội dung: đường liên kết URL đến các trang được lưu trữ bên ngoài. Các đường liên kết này nằm trong tài nguyên AddOnAttachment, xác định các tuyến đường trên web sẽ mở khi người dùng tương tác với tiện ích bổ sung của bạn. Mỗi URL sẽ mở trong các trường hợp cụ thể, hãy xem hướng dẫn về iframe của chúng tôi để biết thông tin chi tiết đầy đủ. Các URL này tương tự như Đường liên kết đến tài nguyên LTI.
Tiện ích bổ sung cho Lớp học không hỗ trợ các loại nội dung khác, chẳng hạn như tệp, hình ảnh hoặc đoạn mã HTML.
Đề xuất: Khi người dùng chọn nội dung trong sản phẩm của bạn, hãy lấy thông tin xác thực OAuth của họ và đưa ra yêu cầu AddOnAttachments.create. Yêu cầu này phải chứa một đối tượng AddOnAttachment chứa các URL cho chế độ xem của học viên, chế độ xem của giáo viên và (không bắt buộc) chế độ xem chấm điểm. Xin lưu ý rằng có các điểm cuối API riêng biệt để tạo tệp đính kèm cho thông báo, bài tập hoặc tài liệu khoá học. Chỉ những tệp đính kèm được tạo trên bài tập mới có thể có chế độ xem chấm điểm, vì đây là loại mục duy nhất trên bảng tin Lớp học chấp nhận bài tập đã nộp của học viên.
So sánh các tính năng của khung
Vị trí tích hợp
Tiện ích bổ sung dành cho Lớp học tạo tệp đính kèm cho thông báo, bài tập và tài liệu khoá học. Đây là những mục xuất hiện trong thẻ Luồng của một khoá học trong giao diện người dùng Lớp học.
Giáo viên bắt đầu quy trình tạo tệp đính kèm bổ sung bằng cách chọn một tiện ích bổ sung trong bộ chọn ở quy trình tạo bài tập. Hãy xem hướng dẫn về iframe để biết thông tin chi tiết về từng khung hiển thị mà người dùng nhìn thấy.
Ngoài ra, nhà phát triển có thể tạo bài tập theo phương thức lập trình bằng tệp đính kèm tiện ích bổ sung. Hãy xem hướng dẫn của chúng tôi về cách tạo tệp đính kèm bên ngoài Google Lớp học để biết thông tin chi tiết.
Thông tin về bối cảnh khởi chạy
Classroom sẽ thêm một số tham số truy vấn vào mỗi URL khi mở một tuyến đường bổ trợ. Các tham số này luôn bao gồm loại mục trong luồng phát và mã nhận dạng cho khoá học và mục trong luồng phát. Các thông tin khác có thể xuất hiện tuỳ thuộc vào chế độ xem iframe, chẳng hạn như mã nhận dạng tệp đính kèm hoặc nội dung gửi, mã thông báo để uỷ quyền tạo tệp đính kèm hoặc URL để nâng cấp từ đường liên kết thành tệp đính kèm của tiện ích bổ sung.
Theo mặc định, Lớp học không truyền bất kỳ thông tin nào về người dùng hoặc tổ chức. Bạn có thể lấy thông tin về người dùng từ tài nguyên UserProfile của Classroom API, bao gồm cả mã nhận dạng người dùng. Nếu người dùng là quản trị viên miền, bạn có thể lấy thông tin về tổ chức từ Workspace Admin SDK.
Xác thực và uỷ quyền
Tiện ích bổ sung cho Lớp học phải sử dụng tính năng Đăng nhập bằng Google để xác thực người dùng. Sau khi đăng nhập, người dùng sẽ cấp quyền cho ứng dụng của bạn thông qua phạm vi OAuth 2.0. Ứng dụng của bạn có thể sử dụng bất kỳ tổ hợp nào của các phạm vi OAuth hiện có.
Khám phá và định cấu hình ứng dụng
Người dùng tìm và "cài đặt" tiện ích bổ sung của Lớp học thông qua Google Workspace Marketplace. Tính năng cài đặt bằng một cú nhấp chuột giúp từng giáo viên có thể sử dụng một ứng dụng tiện ích bổ sung. Quản trị viên có thể cài đặt ứng dụng tiện ích bổ sung cho tất cả giáo viên trong một đơn vị tổ chức hoặc miền (không bắt buộc). Sau đó, tất cả học viên trong một khoá học đều có thể truy cập vào các tệp đính kèm được tạo bằng ứng dụng này. Người dùng cuối không cần quản lý mã thông báo, khoá hoặc giá trị nhận dạng cho từng tiện ích bổ sung của Lớp học.
Trải nghiệm người dùng và quy trình sản phẩm
Trong nhiều trường hợp, quy trình sản phẩm hiện có của công cụ LTI hoạt động hiệu quả dưới dạng một tiện ích bổ sung của Lớp học. Tương tự như công cụ LTI, tiện ích bổ sung Lớp học về cơ bản cho phép bạn tạo và quản lý các đường liên kết đến nội dung của bạn trên nền tảng của chúng tôi. Tệp đính kèm của tiện ích bổ sung dành cho Lớp học tương tự như đường liên kết sâu của LTI. Nếu công cụ LTI của bạn tạo URL trỏ đến nội dung được lưu trữ, thì công cụ đó sẽ hoạt động tốt với vai trò là một tiện ích bổ sung của Lớp học.
Chấm điểm bài tập của học viên
Bạn có thể xem và chấm điểm tệp đính kèm tiện ích bổ sung của Lớp học trong chế độ xem công cụ chấm điểm của Lớp học. Khi đính kèm nội dung yêu cầu học viên nộp bài, bạn sẽ cung cấp một student_work_review_uri để người hướng dẫn có thể xem và chấm điểm bài tập của một học viên cụ thể. Điều này khác với LTI, trong đó một công cụ chỉ xác định một target_link_uri chung cho cả giáo viên và học viên. Việc triển khai tiện ích bổ sung Lớp học tương tự nhất với Dịch vụ xem xét bài tập LTI sắp ra mắt.