Iframe Penemuan Lampiran adalah tampilan awal yang ditampilkan kepada pengajar saat membuka add-on selama pembuatan tugas Classroom. Lampiran adalah konten atau aktivitas yang ingin Anda ajak berinteraksi dengan siswa.
Dari dalam kursus Classroom, pengajar membuat postingan baru (misalnya, tugas, pengumuman, atau pertanyaan) dan memilih add-on dari daftar drop-down add-on (Gambar 1).
Gambar 1. Tampilan pembuatan tugas yang menyertakan opsi add-on yang dapat dilampirkan oleh pengajar.
Setelah pengajar memilih add-on, Classroom akan membuat iframe Penemuan Lampiran dan memuat URL peluncuran add-on. Parameter kueri iframe yang relevan akan diteruskan ke URL peluncuran (Gambar 2).
Gambar 2. Contoh UI penemuan lampiran dalam iframe.
Anggap tampilan Penemuan Lampiran sebagai halaman landing untuk pengajar di add-on Anda. Biasanya, pengajar menggunakan aplikasi web partner dalam iframe untuk memilih konten yang akan dilampirkan ke item aliran mereka. Aplikasi add-on dapat membatasi konten yang ditampilkan, bergantung pada apakah item aliran tersebut adalah pengumuman, tugas, atau materi kursus. Aplikasi add-on kemudian melakukan panggilan Classroom API untuk membuat dan melampirkan lampiran ke tugas.
Setelah pengajar selesai memilih dan membuat lampiran, add-on akan mengirimkan payload postMessage yang meminta iframe ditutup. Iframe akan ditutup dan pengajar kemudian akan melihat lampiran, yang mungkin akan mereka pilih untuk melihat pratinjau atau menghapusnya dari tugas (Gambar 3). Pengajar menyelesaikan alur pembuatan dengan menetapkan item aliran kepada siswa.
Gambar 3. Tampilan pembuatan tugas dengan tiga lampiran add-on jenis aktivitas.
Pertimbangan pengalaman pengguna
- Saat pertama kali dibuka, add-on harus meminta pengajar untuk login.
- Single sign-on Google diperlukan untuk semua panggilan Classroom API. Jika produk Anda memiliki sistem login terpisah, Anda harus menautkan akun.
- Pengajar harus dapat melihat pratinjau lampiran dalam iframe sebelum membuat pilihan akhir.
- Pengajar harus dapat menelusuri atau menjelajahi konten yang dapat dilampirkan.
- Add-on dapat menyediakan berbagai tampilan seperti konten terbaru, konten saya, dan filter menurut keterampilan pembelajaran.
- Add-on harus menyediakan kemampuan untuk membuat item baru yang dapat dilampirkan dari dalam iframe.
Lihat checklist persyaratan add-on Classroom untuk mengetahui detail selengkapnya tentang persyaratan pengalaman pengguna.
Status pemberian lisensi
Jika add-on Anda memerlukan lisensi untuk produk Anda, pesan yang jelas harus ditampilkan untuk menjelaskan cara pengajar tanpa lisensi dapat mengatasi situasi tersebut. Pertimbangkan juga untuk menyembunyikan atau menonaktifkan konten yang tidak tersedia untuk pengajar karena batasan lisensi.