Login dengan lancar

Karena pengalaman login adalah interaksi pertama yang mungkin dilakukan pengguna dengan add-on Anda, penting bagi mereka untuk dapat menyelesaikan alur dengan selancar mungkin. Baca bagian di bawah untuk memahami berbagai API login, parameter kueri terkait login, cara menangani pemblokir pop-up, dan rencana pengujian yang dapat Anda gunakan selama pengembangan untuk memastikan Anda mengikuti praktik terbaik.

Detail penerapan SSO

OAuth 2.0 Google kompatibel dengan banyak stack OAuth 2.0. Sebaiknya Anda menerapkan otorisasi sisi server karena ini adalah 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 didownload.

Pengujian login

Gunakan rencana pengujian add-on untuk memeriksa apakah add-on Anda memenuhi standar yang diperlukan dan dapat menangani kasus ekstrem yang diketahui sebelum Anda mengirimkan add-on untuk ditinjau. Pengujian ini sangat mirip dengan checklist persyaratan add-on Classroom, dan memberikan petunjuk langkah demi langkah tentang cara memeriksa apakah add-on Anda memenuhi persyaratan tersebut. Ini adalah pengujian yang sama dengan yang digunakan untuk menguji aplikasi Anda 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 mengetahui 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. Jendela ini menampilkan layar pemilih akun dan memungkinkan pengguna memberikan izin OAuth. Pemblokir pop-up pengguna akhir dapat mencegahnya menyelesaikan alur login.

Gambar 1. Contoh layar pemilih akun.

Untuk mengatasi masalah ini, berikan tombol kepada pengguna akhir untuk diklik guna melewati 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 pengguna 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.

Jika pengguna yang salah login ke add-on karena masalah multi-login, panggilan Anda ke API add-on Classroom dapat gagal dengan error InvalidAddOnToken. Jika Anda menerima error tersebut, Anda harus menginstruksikan pengguna untuk logout dari semua akun lain di browser atau membuka Classroom di jendela Chrome samaran.