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 bổ trợ và API bổ trợ 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 đây đối với chế độ xem này:

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

    Bạn có thể xác định xem mục luồng có chấp nhận phản hồ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 thuộc 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 câu trả lời của học viên.

  • 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 create bổ sung để 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 Bài tập của học viên và Iframe Chế độ xem của giáo viên đều dùng để trình bày nội dung cho người dùng thay vì sửa đổi bài tập trên 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ã đính kèm của họ.
  • Khi một 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 từ phản hồi với bài tập của học viên. Điều này là bắt buộc để trả lại đ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 thị giao diện người dùng 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 phải đượ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 và sao chép chế độ cài đặt từ bản sao đó để tạo một mô hình tương ứng mới của tệp đính kèm ở phía tiện ích bổ sung. Sau đó, hiển thị giao diện người dùng tệp đính kèm thích hợp.