Karena pengalaman login adalah interaksi pertama yang mungkin dilakukan pengguna dengan add-on Anda, penting bagi mereka untuk dapat menyelesaikan alurnya selancar mungkin. Baca bagian di bawah ini untuk memahami berbagai API login, parameter kueri terkait login, cara menangani pemblokir pop-up, dan rencana pengujian yang dapat digunakan selama pengembangan untuk memastikan Anda mengikuti praktik terbaik.
Detail penerapan SSO
OAuth 2.0 Google kompatibel dengan banyak stack OAuth 2.0. Kami sangat merekomendasikan penerapan otorisasi sisi server karena merupakan opsi keamanan tertinggi dan mendukung penggunaan parameter kueri iframe.
Lihat panduan teknis yang diberikan di situs Google Identity saat menerapkan Login dengan Google. Pastikan untuk mengikuti pedoman branding login Google. File Sketch, SVG, dan EPS disediakan untuk diunduh.
Pengujian login
Gunakan paket pengujian add-on untuk memeriksa apakah add-on Anda memenuhi standar yang diperlukan dan mampu menangani kasus ekstrem yang diketahui sebelum mengirimkan add-on untuk ditinjau. Pengujian ini sangat mencerminkan checklist persyaratan add-on Classroom, dan memberi Anda petunjuk langkah demi langkah tentang cara memeriksa apakah add-on Anda memenuhi persyaratan tersebut. Pengujian ini sama dengan pengujian aplikasi selama publikasi.
Parameter kueri login
Google Classroom menyediakan parameter kueri login_hint untuk membantu memfasilitasi
login berulang. Lihat bagian parameter terkait login di halaman parameter kueri iframe untuk informasi tambahan. Kode contoh dapat ditemukan dalam panduan menangani kunjungan berulang dalam panduan developer kami.
Mengelola pemblokir pop-up
Login ke add-on ini difasilitasi oleh jendela dialog login. Jendela ini menampilkan layar pemilih akun dan memungkinkan pengguna memberikan izin OAuth. Pemblokir pop-up pengguna akhir dapat mencegah mereka menyelesaikan alur login.
Gambar 1. Contoh layar pemilih akun.
Untuk mengatasi masalah ini, sediakan tombol bagi pengguna akhir yang harus mengklik untuk mengabaikan pemblokir pop-up. Interaksi ini memungkinkan dialog login ditampilkan sehingga pengguna akhir dapat melanjutkan alur login. Pastikan tombol yang Anda berikan mengikuti pedoman branding login.
Ikuti panduan login dalam panduan developer kami untuk menerapkan tombol login bermerek Google yang dapat diklik untuk memicu dialog login.
Multi-login
Browser dengan beberapa akun yang login secara bersamaan dapat mengganggu alur penggunaan add-on. Pengguna akhir dapat logout dari semua Akun Google di browser saat ini atau membuka Classroom di jendela Chrome samaran sebelum login dengan akun yang benar dan mencoba lagi operasi tersebut.
Jika pengguna yang salah login ke add-on karena masalah multi-login,
panggilan ke add-on API Classroom mungkin gagal dengan
error InvalidAddOnToken. Jika pesan error tersebut muncul, Anda harus meminta
pengguna logout dari semua akun lainnya di browser atau membuka
Classroom di jendela Chrome samaran.