Karena pengalaman masuk adalah interaksi pertama yang mungkin dilakukan pengguna dengan tambahan, penting bahwa mereka dapat menyelesaikan alurnya dengan mulus sebaik mungkin. Baca bagian di bawah 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 kami.
Detail penerapan SSO
OAuth 2.0 Google kompatibel dengan banyak OAuth 2,0 stack. Kami sangat merekomendasikan penerapan otorisasi sisi server sebagai ini adalah opsi keamanan tertinggi dan mendukung penggunaan kueri iframe parameter.
Lihat panduan teknis yang disediakan di situs Google Identity saat menerapkan login dengan Google. Pastikan untuk mengikuti branding login Google pedoman kami. File Sketch, SVG, dan EPS disediakan untuk didownload.
Pengujian login
Gunakan paket pengujian add-on untuk memeriksa apakah add-on Anda memenuhi standar yang diperlukan dan mampu menangani kasus ekstrem sebelum mengirimkan untuk ditinjau. Pengujian ini sangat mirip dengan add-on Classroom checklist persyaratan, dan memberikan petunjuk langkah demi langkah tentang cara memeriksanya jika add-on Anda memenuhi persyaratan tersebut. Ini adalah pengujian yang sama dengan aplikasi Anda diuji selama publikasi.
Parameter kueri login
Google Classroom menyediakan parameter kueri login_hint untuk membantu memfasilitasi
login berulang. Lihat bagian parameter terkait login dari iframe
parameter kueri untuk informasi tambahan. Kode contoh dapat ditemukan di
panduan penanganan kunjungan berulang dalam panduan developer kami.
Mengelola pemblokir pop-up
Login ke add-on difasilitasi oleh jendela dialog login. Ini menampilkan layar pemilih akun dan memungkinkan pengguna memberikan OAuth izin akses. Pemblokir pop-up pengguna akhir dapat mencegah mereka menyelesaikan alur login.
Gambar 1. Contoh layar pemilih akun.
Untuk mengatasi masalah ini, berikan tombol kepada pengguna akhir untuk mengklik untuk mengabaikan pemblokir pop-up. Interaksi ini memungkinkan dialog login ditampilkan sehingga pengguna akhir dapat melanjutkan proses login. Pastikan tombol yang Anda berikan mengikuti pedoman branding login.
Ikuti panduan login di 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 {i>add-on<i} di alur pengguna. Pengguna akhir dapat logout dari semua Akun Google di browser saat ini atau buka Classroom di jendela Chrome samaran sebelum masuk dengan akun yang benar dan mencoba kembali operasi tersebut.
Jika pengguna yang salah login ke add-on karena masalah multi-login,
panggilan Anda ke Classroom add-on API mungkin gagal dengan
Error InvalidAddOnToken. Jika Anda menerima pesan {i>error<i} seperti itu, Anda harus menginstruksikan
pengguna untuk logout dari semua akun lain di browser atau membuka
Classroom di jendela Chrome samaran.