Otorisasi untuk Layanan Google

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

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 Anda) secara otomatis, berdasarkan pemindaian kode. Kode yang diberi komentar masih dapat menghasilkan permintaan otorisasi. Jika skrip memerlukan otorisasi, Anda akan melihat salah satu dialog otorisasi yang ditampilkan di sini saat dijalankan.

Skrip yang sebelumnya telah Anda otorisasi juga meminta otorisasi tambahan jika perubahan kode menambahkan layanan baru. Skrip tidak boleh meminta otorisasi jika Anda mengakses skrip sebagai aplikasi web yang berjalan dengan identitas pengguna skrip.

Mencabut hak akses

Untuk mencabut akses skrip ke data Anda, ikuti langkah-langkah berikut:

  1. Buka halaman izin untuk akun Google Anda. (Untuk membuka halaman ini di masa mendatang, kunjungi Google.com, lalu klik gambar akun Anda di sudut kanan atas layar. Berikutnya, klik Akun Saya, lalu Aplikasi &situs yang terhubung di bagian "Login & keamanan" kemudian, Kelola Aplikasi.)
  2. Klik nama skrip yang otorisasinya ingin Anda cabut, lalu klik Remove di sebelah kanan, lalu OK pada dialog yang dihasilkan.

Izin dan jenis skrip

Identitas pengguna yang dijalankan skrip — dan dengan demikian data yang dapat diakses — bervariasi berdasarkan skenario menjalankan skrip, seperti yang ditunjukkan pada tabel di bawah ini.

Jenis skrip Skrip berjalan sebagai...
Mandiri, add-on, atau terikat dengan Dokumen, Spreadsheet, Slide, atau Formulir Pengguna di keyboard
Fungsi kustom di spreadsheet Pengguna anonim; tetapi, batas kuota diperhitungkan terhadap pengguna di keyboard
Aplikasi web atau gadget Google Sites Pengguna di pemilik keyboard atau 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 Anda 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 tingkat file:

/**
 * @OnlyCurrentDoc
 */

Anotasi lawan, @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 seperti skrip yang terikat ke dokumen. Namun, dalam situasi tertentu, fungsi onOpen(e) dan onEdit(e) fungsi berjalan dalam mode tanpa otorisasi yang menimbulkan beberapa detail tambahan. Untuk 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 pada batas otorisasi. Lihat batas pengguna aplikasi OAuth untuk mengetahui detailnya.