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 của bạn và API tiện ích bổ sung của Google Lớp học.

Iframe khám phá tệp đính kèm

iframe 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 đối với chế độ xem này:

  • Khi iframe Khám phá tệp đính kèm 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 và nhận giá trị supportsStudentWork.
  • Hiển thị giao diện người dùng của quy trình tạo hoặc khám phá nội dung. Bạn có thể bỏ qua các tệp đính kèm loại hoạt động dựa trên giá trị của supportsStudentWork trong phản hồi xác thực khởi chạy.
  • Dựa trên lựa chọn của giáo viên, hãy tạo một hoặc nhiều yêu cầu bổ sung cho create để thêm tệp đính kèm vào bài tập.

Các iframe khác

iframe Chế độ xem của học viên, iframe trong Chế độ xem bài tập của học viên và iframe trong Chế độ xem của giáo viên để 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 liên quan đến các khung hiển thị này:

  • Khi iframe mở ra, hãy lấy sự đồng ý của người dùng bằng OAuth, sau đó xác thực vai trò và mã tệp đính kèm của họ.

    • Nếu người dùng hiện tại là học viên, hãy liên kết submissionId trong phản hồ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 giữa các khung hiển thị trùng khớp với nhau.
    • Nếu attachmentId đã được biết với tiện ích bổ sung, hãy hiển thị giao diện người dùng của tệp đính kèm thích hợp.
    • Nếu không, thì 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 biết, rồi sao chép chế độ cài đặt từ tiện ích bổ sung đó để tạo một mô hình mới tương ứng của tệp đính kèm ở phía tiện ích bổ sung. Sau đó, hãy hiển thị giao diện người dùng của tệp đính kèm thích hợp.