Otorisasi untuk Layanan Google

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 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:

  1. 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.)
  2. 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.