Chiến lược triển khai

Trang này cung cấp thông tin tổng quan ngắn gọn về các hoạt động tương tác chính giữa ứng dụng web tiện ích bổ sung và API tiện ích bổ sung của Google Lớp học.

iframe của tính năng Khám phá tệp đính kèm

iframe của tính năng Khám phá tệp đính kèm là trang đích dành cho giáo viên trong tiện ích bổ sung của bạn. Hãy cân nhắc thực hiện các hành động sau đây đối với chế độ xem này:

  • Hiển thị giao diện người dùng khám phá hoặc sáng tạo nội dung.

    Bạn có thể tuỳ ý xác định xem mục trong bảng tin có chấp nhận câu trả lời của học viên hay không, vì bạn có thể muốn ngăn giáo viên thêm tệp đính kèm loại hoạt động. Kiểm tra giá trị của tham số truy vấn itemType đã được truyền khi mở iframe của tiện ích bổ sung. Chỉ loại courseWork mới chấp nhận phản hồi của học viên.

  • Dựa trên lựa chọn của giáo viên, hãy thực hiện một hoặc nhiều yêu cầu create tiện ích bổ sung để thêm tệp đính kèm vào bài tập.

Các iframe khác

iframe trong Chế độ xem của học viên, iframe trong bài đánh giá của học viên và iframe trong Chế độ xem của giáo viên đều nhằm mục đích trình bày nội dung cho người dùng thay vì sửa đổi bài tập trong Lớp học. Hãy cân nhắc thực hiện các hành động sau đây đối với các chế độ xem này:

  • Khi một iframe mở ra, hãy lấy sự đồng ý của người dùng về OAuth, sau đó xác thực vai trò và mã tệp đính kèm của họ.
  • Khi iframe mở ra, hãy tạo một courseWork.GetAddOnContextRequest, courseWorkMaterials.GetAddOnContextRequest hoặc announcements.GetAddOnContextRequest dựa trên itemType để xác thực vai trò của người dùng.
  • Nếu người dùng hiện tại là học viên, hãy liên kết submissionId trong câu trả lời với bài tập của học viên. Đây là yêu cầu bắt buộc để trả điểm và hiển thị bài tập của học viên cho giáo viên trong công cụ chấm điểm; submissionIds khớp trên các chế độ xem.
  • Nếu tiện ích bổ sung đã biết attachmentId, hãy hiện giao diện người dùng tệp đính kèm thích hợp.
  • Nếu không, đó phải là trường hợp bài đăng gốc của tệp đính kèm này được sao chép từ một bài đăng hoặc khoá học khác. Sử dụng copyHistory để xác định bản sao gần đây nhất mà tiện ích bổ sung nhận biết được rồi sao chép các chế độ cài đặt từ đó để tạo một mô hình mới tương ứng của tệp đính kèm trên tiện ích bổ sung. Sau đó, hãy hiện giao diện người dùng đính kèm thích hợp.