Iframe Penemuan Lampiran adalah tampilan awal yang ditampilkan kepada pengajar saat membuka add-on selama pembuatan tugas Classroom. Channel lampiran adalah konten atau aktivitas yang ingin Anda sampaikan kepada siswa berinteraksi.
Dari dalam kursus Classroom, seorang pengajar membuat postingan baru (untuk (misalnya, tugas, pengumuman, atau pertanyaan) dan memilih add-on dari daftar {i>add-on<i}. Untuk waktu yang singkat (pada urutan jam), Classroom memungkinkan add-on untuk 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 Lampiran iframe Discovery dan memuat URL peluncuran add-on. Kueri iframe apa pun yang relevan parameter diteruskan ke URL peluncuran.
Gambar 2. Contoh UI penemuan lampiran dalam iframe.
Pengajar tersebut menggunakan aplikasi web partner, dalam iframe, untuk memilih
lampiran. Aplikasi melakukan panggilan Classroom API untuk melampirkan lampiran
ke tugas. Setelah pengajar selesai memilih lampiran,
add-on mengirimkan payload postMessage yang meminta iframe ditutup.
Iframe ditutup dan pengajar sekarang dapat melihat lampiran yang mungkin mereka memilih untuk melihat pratinjau atau menghapusnya dari tugas.
Gambar 3. Tampilan pembuatan tugas dengan tiga add-on jenis aktivitas lampiran.
Pertimbangan UX dalam iframe
- Saat dibuka di awal, add-on harus meminta pengajar untuk login.
- Single sign-on Google diperlukan untuk semua panggilan Classroom API. Jika produk Anda memiliki sistem {i>login<i} terpisah, Anda harus menautkan akun.
- Pengajar harus dapat melihat pratinjau lampiran dalam iframe sebelum saat menentukan pilihan akhir.
- Seorang pengajar harus dapat menelusuri, atau menjelajahi, yang dapat dilampirkan saat ini.
- Add-on dapat menyediakan berbagai penayangan seperti konten terbaru, konten, dan memfilter berdasarkan 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 UX.
Menampilkan status pemberian lisensi dalam iframe
Jika add-on memerlukan lisensi, dan pengajar tidak memilikinya, pesan harus disampaikan kepada pengajar untuk memberitahukan hal berikutnya langkah-langkah 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 Penemuan Lampiran iframe.
- Menyembunyikan atau menonaktifkan konten yang tidak tersedia bagi pengajar karena pemberian lisensi batasan level.