{i>add-on<i} mengharuskan otorisasi dari pengguna sebelum mereka dapat beroperasi. Hal ini berlaku untuk add-on yang dipublikasikan dan diinstal dari Google Workspace Marketplace serta add-on yang Anda kembangkan sendiri.
Mengizinkan add-on yang dipublikasikan
Setelah Anda menginstal add-on yang dipublikasikan, alur otorisasi akan segera dimulai:
- Anda akan diminta untuk memilih Pilih akun untuk menginstal add-on.
- Kemudian, Anda akan melihat daftar otorisasi yang diperlukan add-on untuk beroperasi, sehingga Anda tahu apa saja yang akan dilakukannya. Tinjau daftar ini dengan cermat, dan jika Anda masih ingin memberikan otorisasi, klik Izinkan. Tindakan ini memungkinkan add-on untuk digunakan.
- Kini Anda dapat menjalankannya dari aplikasi host yang diperluas. Jika aplikasi sudah terbuka di tab browser, Anda mungkin perlu memuat ulang tab sebelum add-on tersedia.
Jika add-on yang Anda instal nanti diupdate dan memerlukan otorisasi tambahan yang belum diberikan, Anda akan diminta untuk memberikan izin tersebut pada saat add-on digunakan kembali.
Mengizinkan Add-on Google Workspace yang tidak dipublikasikan
Add-on yang tidak dipublikasikan tidak memiliki alur otorisasi yang sama dengan add-on yang dipublikasikan karena belum tercantum di Google Workspace Marketplace. Setelah menginstal add-on yang tidak dipublikasikan, Anda tidak akan langsung diminta untuk memberi otorisasi. Sebagai gantinya, alur otorisasi akan dimulai saat Anda pertama kali mencoba menggunakan add-on.
Saat dijalankan, add-on akan menentukan apakah otorisasi pengguna diperlukan. Jika otorisasi diperlukan, add-on akan memberikan kartu otorisasi. Otorisasi selalu diperlukan saat add-on pertama kali dijalankan, dan mungkin juga diperlukan jika versi add-on baru menggunakan layanan yang sebelumnya tidak diberi otorisasi. Tombol Authorize Access menyediakan jendela dialog bagi pengguna untuk Mengizinkan atau Menolak otorisasi untuk add-on.
Mengizinkan layanan non-Google untuk Add-on Google Workspace
Add-on Google Workspace dapat terhubung ke layanan pihak ketiga yang memerlukan otorisasi. Add-on Google Workspace yang terhubung ke layanan tersebut memerlukan dua tindakan terpisah dari pengguna:
- Otorisasi add-on itu sendiri saat add-on diinstal atau pertama kali dimulai.
- Otorisasi layanan non-Google saat pertama kali diakses.
Jika Add-on Google Workspace yang Anda kembangkan perlu mengakses layanan non-Google menggunakan OAuth, Anda harus mengonfigurasi koneksi untuk layanan tersebut saat membuat add-on.
Saat otorisasi layanan non-Google diperlukan, Add-on Google Workspace akan memberi pengguna kartu permintaan otorisasi untuk layanan tersebut. Anda dapat menyesuaikan permintaan otorisasi ini jika ingin, atau menggunakan kartu default.
Untuk mengetahui detail selengkapnya, lihat panduan Menghubungkan ke layanan non-Google.
Sistem konferensi pihak ketiga
Add-on Google Workspace yang memperluas Google Kalender juga dapat menambahkan solusi konferensi tambahan yang memungkinkan pengguna memilih sistem konferensi pihak ketiga saat mengedit acara Google Kalender. Jika add-on Anda menyediakan opsi konferensi yang mengharuskan pengguna untuk login, add-on Anda harus memberi pengguna kemampuan untuk melakukannya.
Jika pengguna mencoba membuat konferensi dengan add-on Anda tanpa login yang diperlukan, metode onCreateFunction solusi konferensi akan menampilkan objek ConferenceData yang berisi ConferenceError dengan URL autentikasi.
Setelah menerima objek ini, Google Kalender akan membuat tombol LOGIN di UI pengeditan acara yang tertaut ke URL autentikasi yang disediakan add-on. Kemudian, pengguna dapat menggunakan tombol ini untuk login ke sistem pihak ketiga sebelum menggunakan add-on lebih lanjut.
Lihat Membuat konferensi pihak ketiga untuk mengetahui detail selengkapnya tentang cara menangani otorisasi menggunakan ConferenceError.
Mengizinkan Add-on Editor yang tidak dipublikasikan
Praktik terbaiknya adalah menguji Add-on Editor saat Anda mengembangkannya. Alur otorisasi identik dengan alur untuk Add-on Editor yang dipublikasikan, tetapi alurnya dimulai saat Anda pertama kali mencoba menguji add-on. Jika nantinya Anda menguji ulang add-on yang sama, Anda tidak akan dimintai otorisasi lagi.
Membatalkan otorisasi add-on
Saat mengembangkan add-on, sebaiknya batalkan otorisasi agar Anda dapat menguji ulang alur otorisasi.
Anda dapat membatalkan otorisasi add-on dengan melakukan hal berikut:
- Buka konsol keamanan akun.
- Cari dan klik add-on yang ingin Anda batalkan otorisasinya.
- Klik HAPUS AKSES.
Saat Anda menjalankan add-on lagi setelah membatalkan izinnya, alur otorisasi akan ditampilkan lagi.