Apps Script memerlukan otorisasi pengguna untuk mengakses data pribadi dari layanan Google bawaan atau layanan Google lanjutan.
Memberikan hak akses
Apps Script menentukan cakupan otorisasi (seperti mengakses file Google Spreadsheet atau Gmail) secara otomatis berdasarkan pemindaian kode. Kode yang sebagai komentar masih dapat membuat permintaan otorisasi. Jika skrip memerlukan otorisasi, Anda akan melihat salah satu dialog otorisasi ditampilkan di sini saat dijalankan.
Skrip yang telah Anda izinkan sebelumnya juga meminta otorisasi tambahan jika perubahan kode menambahkan layanan baru. Skrip mungkin tidak meminta otorisasi jika Anda mengakses skrip sebagai aplikasi web yang berjalan berdasarkan identitas pengguna pemilik skrip.
Mencabut hak akses
Untuk mencabut akses skrip ke data Anda, ikuti langkah-langkah berikut:
- Buka halaman izin untuk Akun Google Anda. (Untuk membuka halaman ini pada masa mendatang, kunjungi Google.com, lalu klik gambar akun Anda di pojok kanan atas layar. Selanjutnya, klik Akun Saya, lalu Aplikasi & situs yang terhubung di bagian "Login & keamanan", lalu Kelola Aplikasi.)
- Klik nama skrip yang otorisasinya ingin Anda cabut, lalu klik Remove di sebelah kanan, lalu OK di dialog yang muncul.
Izin dan jenis skrip
Identitas pengguna yang digunakan oleh skrip — sehingga data yang dapat diaksesnya — bervariasi berdasarkan skenario yang digunakan untuk menjalankan skrip, seperti yang ditunjukkan pada tabel di bawah.
| Jenis skrip | Skrip berjalan sebagai... |
|---|---|
| Mandiri, add-on, atau terikat dengan Dokumen, Spreadsheet, Slide, atau Formulir | Pengguna di keyboard |
| Fungsi kustom dalam spreadsheet | Pengguna anonim; tetapi, batas kuota akan mengurangi pengguna di keyboard |
| Aplikasi web atau gadget Google Sites | Pengguna di keyboard atau pemilik skrip, bergantung pada opsi yang dipilih saat men-deploy aplikasi |
| Pemicu yang dapat diinstal | Pengguna yang membuat pemicu |
Cakupan otorisasi manual untuk Spreadsheet, Dokumen, Slide, dan Formulir
Jika membuat add-on atau skrip lain yang menggunakan layanan Spreadsheet, layanan Dokumen, layanan Slide, atau Layanan Formulir, Anda dapat memaksa dialog otorisasi untuk hanya meminta akses ke file yang menggunakan add-on atau skrip, bukan semua spreadsheet, dokumen, atau formulir pengguna. Untuk melakukannya, sertakan anotasi JsDoc berikut dalam komentar level file:
/**
* @OnlyCurrentDoc
*/
Anotasi yang berlawanan, @NotOnlyCurrentDoc, tersedia jika skrip Anda
menyertakan library yang mendeklarasikan
@OnlyCurrentDoc, tetapi skrip master sebenarnya memerlukan akses ke lebih dari
file saat ini.
Siklus proses otorisasi untuk add-on
Add-on untuk Google Spreadsheet, Dokumen, Slide, dan Formulir umumnya mengikuti model otorisasi yang sama dengan skrip yang
terikat ke dokumen. Namun, dalam keadaan
tertentu, fungsi onOpen(e) dan onEdit(e) berjalan dalam
mode tanpa otorisasi yang menghadirkan beberapa detail tambahan. Untuk mengetahui informasi
selengkapnya, lihat
panduan siklus proses otorisasi add-on.
Batas pengguna aplikasi OAuth
Aplikasi yang menggunakan OAuth untuk mengakses data pengguna Google, termasuk project Apps Script, tunduk kepada batas otorisasi. Lihat Batas pengguna aplikasi OAuth untuk mengetahui detailnya.