Apps Script memerlukan otorisasi pengguna untuk mengakses data pribadi dari layanan Google bawaan atau layanan Google lanjutan.
Memberikan hak akses
![](https://developers-dot-devsite-v2-prod.appspot.com/static/apps-script/images/new-auth-1.png?authuser=19&hl=id)
![](https://developers-dot-devsite-v2-prod.appspot.com/static/apps-script/images/new-auth-2.png?authuser=19&hl=id)
Apps Script menentukan cakupan otorisasi (seperti mengakses Google Spreadsheet atau Gmail) secara otomatis, berdasarkan pemindaian kode. Kode yang sebagai komentar, masih dapat membuat permintaan otorisasi. Jika suatu skrip perlu otorisasi, Anda akan melihat salah satu dialog otorisasi yang ditampilkan di sini ketika akan dijalankan.
Skrip yang telah Anda izinkan sebelumnya juga meminta izin otorisasi jika perubahan kode menambahkan layanan baru. Skrip tidak boleh meminta jika Anda mengakses skrip sebagai aplikasi web yang berjalan di bawah identitas pengguna pemilik skrip.
Mencabut hak akses
Untuk mencabut akses skrip ke data Anda, ikuti langkah-langkah berikut:
- Kunjungi halaman izin untuk Akun Google Anda. (Untuk menavigasi ke halaman ini di masa mendatang, kunjungi Google.com, lalu klik gambar akun Anda di pojok kanan atas layar. Selanjutnya, klik Akun Saya, lalu Aplikasi yang terhubung & di bawah "Login & keamanan" bagian, lalu Manage Apps.)
- Klik nama skrip yang otorisasinya ingin Anda cabut, lalu klik Remove di sebelah kanan, lalu OK pada dialog yang muncul.
Izin dan jenis skrip
Identitas pengguna yang digunakan skrip untuk dijalankan — dan dengan demikian data yang dapat diakses oleh skrip — bervariasi berdasarkan skenario di mana skrip dijalankan, seperti yang ditunjukkan pada tabel di bawah ini.
Jenis skrip | Skrip berjalan sebagai... |
---|---|
Mandiri, add-on, atau terikat ke Dokumen, Spreadsheet, Slide, atau Formulir | Pengguna di keyboard |
Fungsi kustom di spreadsheet | Pengguna anonim; tetapi, batas kuota dihitung terhadap pengguna di keyboard |
Aplikasi web atau Widget Google Sites | Pengguna di keyboard atau pemilik skrip, bergantung pada opsi dipilih saat men-deploy aplikasi |
Pemicu yang dapat diinstal | Pengguna yang membuat pemicu |
Cakupan otorisasi manual untuk Spreadsheet, Dokumen, Slide, dan Formulir
Jika Anda membuat add-on atau skrip lain yang menggunakan layanan Spreadsheet, Layanan dokumen, Layanan Slide, atau Layanan Formulir, Anda dapat memaksa otorisasi dialog yang hanya meminta akses ke file yang menggunakan add-on atau skrip, bukan semua {i>spreadsheet<i}, 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 menyatakan
@OnlyCurrentDoc
, namun 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 seperti skrip yang
terikat ke dokumen. Pada
keadaan, namun, fungsi onOpen(e)
dan onEdit(e)
-nya berjalan dalam
mode tanpa otorisasi yang menyebabkan
beberapa detail tambahan. Untuk selengkapnya
informasi tersebut, lihat
panduan siklus proses otorisasi add-on.
Batas pengguna aplikasi OAuth
Aplikasi yang menggunakan OAuth untuk mengakses data pengguna Google, termasuk Aplikasi Project skrip tunduk kepada batas otorisasi. Lihat Batas pengguna aplikasi OAuth untuk mengetahui detailnya.