Add-on Google Classroom harus menggunakan single sign-on (SSO) Google untuk mengidentifikasi dan mengautentikasi pengguna.
Lihat Panduan OpenID Connect Google Identity untuk informasi lebih lanjut tentang SSO. Sebaiknya baca juga dokumentasi resmi Google tentang pendaftaran dan login pengguna untuk login otomatis dan Pedoman Branding Login.
Lihat halaman login tanpa kendala untuk panduan penerapan SSO Google di add-on Classroom. Panduan login yang lancar juga merujuk pada paket pengujian yang dapat digunakan untuk memastikan add-on Anda mengikuti praktik terbaik login.
Alur login
Untuk mengurangi hambatan login bagi pengguna, Google Classroom menyediakan dua parameter
kueri saat iframe dibuka: login_hint dan hd. hd adalah domain
pengguna, dan diberikan saat pengguna pertama kali membuka add-on Anda. login_hint adalah
ID Google unik pengguna, dan diberikan setelah pengguna login ke
add-on Anda untuk pertama kalinya. Parameter ini memberikan konteks tentang pengguna
yang login ke Google Classroom. Lihat halaman panduan parameter login kami untuk mengetahui pembahasan yang lebih mendetail tentang parameter kueri ini.
Saat dialog login ditampilkan, gunakan parameter kueri hd untuk memfilter domain tidak valid yang menyederhanakan pilihan akun. Anda harus menampilkan dialog login
Google jika parameter kueri login_hint pada pengguna Google Classroom
saat ini tidak cocok dengan pengguna add-on yang login. Tombol tersebut harus mematuhi pedoman branding Google. Jika sudah login, pengguna tidak akan diminta untuk login lagi.
Gambar 1. Alur login saat pengguna pertama kali meluncurkan add-on Anda.
Penginstalan individual akan menambahkan add-on ke akun pengguna. Pengguna akan diminta untuk mengizinkan cakupan akses add-on jika add-on diinstal satu per satu.
Penginstalan administrator menambahkan add-on ke salah satu atau semua akun di domain, dan hanya dapat dilakukan oleh administrator domain. Secara opsional, administrator dapat mengizinkan semua cakupan akses atas nama semua pengguna di domain; pengguna tidak diminta untuk mengizinkan cakupan akses apa pun jika administrator memilih untuk melakukannya.
Lihat Setelan penginstalan untuk mengetahui informasi selengkapnya.