Pengguna akan menggunakan Konektor Komunitas Anda untuk membuat sumber datanya sendiri. Untuk sumber data ini, konektor Anda dapat mengakses identitas pengguna yang efektif. Bergantung pada Kredensial sumber data, pengguna yang efektif dapat berupa pembuat sumber data (kredensial Pemilik) atau pelihat laporan (kredensial Pelihat).
Manfaat
- Anda dapat mengakses layanan dan API Google atas nama pengguna.
- Anda dapat menerapkan kontrol akses kustom untuk memastikan hanya data relevan yang ditampilkan.
- Anda dapat menyesuaikan pengalaman pengguna untuk pengguna yang efektif.
Langkah-langkah implementasi
Mengakses token OAuth pengguna
Konektor Anda dapat mengakses layanan dan API Google atas nama pengguna dengan meneruskan token OAuth pengguna. Untuk mengakses token OAuth pengguna yang efektif di konektor Anda, gunakan ScriptApp.getOAuthToken(). Lihat referensi getOAuthToken.
Token ini akan mencakup Cakupan otorisasi yang disertakan selama otorisasi konektor.
Untuk sebagian besar konektor, Apps Script otomatis mendeteksi cakupan yang diperlukan dengan mengurai dan memproses skrip. Anda dapat melihat cakupan yang digunakan konektor kapan saja. Anda juga dapat menetapkan cakupan secara eksplisit dalam manifes menggunakan string URL. Jika Anda ingin mengakses layanan atau API Google atas nama pengguna, sertakan cakupan yang relevan tersebut dalam manifes.
Mengakses alamat email pengguna
Dalam kode, Anda dapat mengidentifikasi pengguna yang efektif saat ini dengan Session.getEffectiveUser().getEmail(). Lihat referensi getEffectiveUser.
Menambahkan kode ini akan otomatis menambahkan
cakupan otorisasi https://www.googleapis.com/auth/userinfo.email ke konektor
Anda.
Contoh: Memanggil Google API dengan token OAuth pengguna
- Konektor Google Fit mengambil data dari Google Fit API untuk pengguna yang efektif. Saat memanggil API, token OAuth pengguna yang efektif akan diteruskan. Lihat kode sumber untuk mengetahui detail penerapan.
- Konektor Firestore menggunakan Cloud Resource Manager untuk mendapatkan daftar project bagi pengguna yang efektif. Konektor ini juga meneruskan token OAuth pengguna yang efektif. Lihat kode sumber untuk mengetahui detail implementasi.
Contoh: isAdminUser() berdasarkan alamat email
- Chrome UX Connector mengelola daftar pengguna admin. Contoh ini menggunakan
getEffectiveUser()dan membandingkan pengguna yang efektif dengan daftar untuk menentukan apakah pengguna yang efektif adalah admin atau bukan. Lihat penerapangetEffectiveUser.