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 gunakan untuk berinteraksi dengan siswa.
Dari dalam kursus Classroom, pengajar membuat postingan baru (misalnya, tugas, pengumuman, atau pertanyaan) dan memilih add-on dari menu drop-down add-on. Untuk waktu singkat (dalam urutan jam), Classroom memungkinkan add-on menambahkan lampiran ke postingan.
Gambar 1. Tampilan
pembuatan tugas termasuk kemungkinan 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. Contoh UI penemuan lampiran dalam iframe.
Pengajar menggunakan aplikasi web partner, dalam iframe, untuk memilih
lampiran. Aplikasi akan melakukan panggilan API Classroom untuk melampirkan lampiran
ke tugas. Setelah pengajar selesai memilih lampiran, add-on akan mengirimkan payload postMessage yang meminta iframe ditutup.
iframe ditutup dan pengajar kini dapat melihat lampiran yang dapat mereka pilih untuk dipratinjau atau dihapus dari tugas.
Gambar 3. Tampilan pembuatan tugas dengan tiga lampiran add-on jenis aktivitas.
Pertimbangan UX dalam iframe
- Saat dibuka untuk pertama kalinya, 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 menentukan pilihan akhir.
- Pengajar harus dapat menelusuri atau menjelajahi konten yang dapat dilampirkan.
- Add-on dapat memberikan berbagai tampilan seperti konten terbaru, konten saya, dan filter berdasarkan keterampilan belajar.
- 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 UX.
Menampilkan status pemberian lisensi dalam iframe
Jika add-on memerlukan lisensi, dan pengajar tidak memilikinya, pesan yang jelas harus disampaikan kepada pengajar yang memberi tahu mereka tentang langkah berikutnya yang tepat untuk memperbaiki situasi tersebut. Hal ini untuk mencegah kebingungan yang mungkin timbul dari pembatasan pemberian lisensi.
Kami juga merekomendasikan agar add-on Anda:
- Menampilkan tingkat pemberian lisensi pengajar dalam iframe Penemuan Lampiran.
- Menyembunyikan atau menonaktifkan konten yang tidak tersedia untuk pengajar karena adanya pembatasan tingkat pemberian lisensi.