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 tiện ích bổ sung trên web của bạn và API tiện ích bổ sung 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. 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.

    Xác định xem mục luồng có chấp nhận câu trả lời của học viên hay không (không bắt buộc) vì bạn có thể muốn ngăn giáo viên thêm loại hoạt động tệp đính kèm. Kiểm tra giá trị của tham số truy vấn itemType đã được khi mở iframe của tiện ích bổ sung. Chỉ loại courseWork 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 bổ sung create để 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 để đánh giá bài tập của học viên và Chế độ xem của giáo viên tất cả iframe đều nhằm mục đích hiển thị 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 về các chế độ xem này:

  • Khi iframe mở ra, hãy lấy sự đồng ý sử dụng OAuth của người dùng rồi xác thực các URL đó mã vai trò và tệp đính kèm.
  • 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 nội dung 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à để cho giáo viên xem bài tập của học sinh trong công cụ chấm điểm; thời gian submissionIds trùng khớp trên các lượt xem.
  • Nếu tiện ích bổ sung đã biết attachmentId, hãy hiện tham số thích hợp giao diện người dùng của tệp đính kèm.
  • 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 là 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 mà tiện ích bổ sung nhận biết được và sao chép các chế độ cài đặt từ tiện ích đó sang 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 đó: hiển thị giao diện người dùng đính kèm thích hợp.