Skrip yang terikat penampung

Skrip terikat ke file Google Spreadsheet, Google Dokumen, Google Slide, atau Google Formulir jika dibuat dari dokumen tersebut, bukan sebagai skrip mandiri. File yang dilampirkan ke skrip terikat disebut "penampung". Skrip terikat umumnya berperilaku seperti skrip mandiri, kecuali bahwa skrip tersebut tidak muncul di Google Drive, tidak dapat dilepas dari file yang terikat dengannya, dan mendapatkan beberapa hak istimewa khusus atas file induk.

Skrip juga dapat terikat ke Google Sites, tetapi skrip ini hampir selalu di-deploy sebagai aplikasi web. Skrip yang terikat ke Spreadsheet, Dokumen, Slide, atau Formulir juga dapat menjadi aplikasi web, meskipun hal ini jarang terjadi.

Skrip terikat pada dasarnya adalah add-on Google Workspace yang tidak dipublikasikan dan hanya berfungsi untuk file yang terikat dengannya.

Membuat skrip terikat

Anda dapat membuat skrip terikat di Dokumen, Spreadsheet, Slide, dan Formulir.

Dokumen, Spreadsheet, atau Slide

Untuk membuat skrip terikat di Dokumen, Spreadsheet, atau Slide, buka dokumen di Dokumen, spreadsheet di Spreadsheet, atau presentasi di Slide, lalu klik Ekstensi > Apps Script. Untuk membuka kembali skrip di masa mendatang, lakukan hal yang sama atau buka skrip dari dasbor Apps Script.

Formulir

Untuk membuat skrip terikat di Formulir, buka formulir, lalu klik Lainnya > Editor skrip. Untuk membuka kembali skrip di masa mendatang, lakukan hal yang sama atau buka skrip dari dasbor Apps Script.

Alat clasp tidak dapat membuat skrip terikat, tetapi dapat meng-clone dan mengeditnya.

Metode khusus

Skrip terikat dapat memanggil beberapa metode yang tidak dapat dilakukan oleh skrip mandiri:

getActiveSpreadsheet, getActiveDocument, getActivePresentation, dan getActiveForm memungkinkan skrip terikat merujuk ke file induknya tanpa merujuk ke ID file.
getUi memungkinkan skrip terikat mengakses antarmuka pengguna untuk file induknya guna menambahkan menu, dialog, dan sidebar kustom.
Di Spreadsheet, getActiveSheet, getActiveRange, dan getActiveCell biarkan skrip menentukan sheet saat ini pengguna, rentang sel yang dipilih, atau sel individual yang dipilih. setActiveSheet dan setActiveRange memungkinkan skrip mengubah pilihan tersebut.
Di Dokumen, getActiveTab, getCursor, dan getSelection izinkan skrip menentukan tab pengguna saat ini, posisi kursor pengguna, atau teks yang dipilih. setActiveTab, setCursor dan setSelection memungkinkan skrip mengubah pilihan tersebut.

Untuk mengetahui informasi selengkapnya, lihat panduan untuk memperluas Spreadsheet atau panduan untuk memperluas Dokumen.

Metode ini hanya tersedia untuk skrip terikat yang dijalankan dari editor skrip, item menu, dialog, sidebar, atau pemicu. Saat skrip terikat dijalankan sebagai aplikasi web atau menggunakan Google Apps Script API, metode ini tidak tersedia.

Menu, dialog, dan sidebar kustom

Skrip terikat dapat menyesuaikan Spreadsheet, Dokumen, dan Formulir dengan menambahkan menu kustom dan kotak dialog atau sidebar. Skrip hanya dapat berinteraksi dengan antarmuka pengguna untuk instance file terbuka saat ini. Skrip yang terikat ke satu dokumen tidak dapat memengaruhi antarmuka pengguna dokumen lain.

Pemicu

Skrip terikat dapat menggunakan pemicu sederhana seperti fungsi onOpen khusus, yang berjalan secara otomatis setiap kali file dibuka oleh pengguna yang memiliki akses edit. Seperti semua jenis skrip, skrip ini juga dapat menggunakan pemicu yang dapat diinstal.

Fungsi kustom

Fungsi kustom adalah fungsi dalam skrip yang terikat ke Spreadsheet yang Anda panggil langsung dari sel menggunakan sintaksis =myFunctionName(). Fungsi kustom mirip dengan ratusan fungsi bawaan di Spreadsheet seperti AVERAGE atau SUM, tetapi Anda menentukan perilaku fungsi kustom.

Akses ke skrip terikat

Hanya pengguna yang memiliki izin untuk mengedit penampung yang dapat menjalankan skrip terikatnya. Kolaborator yang hanya memiliki akses lihat tidak dapat membuka editor skrip. Jika mereka membuat salinan file penampung, mereka akan menjadi pemilik salinan dan dapat melihat dan menjalankan salinan skrip.

Untuk mempelajari cara membagikan file penampung skrip, lihat Membagikan file dari Drive.

Semua skrip terikat penampung menggunakan daftar akses pemilik, pelihat, dan editor yang sama yang ditentukan untuk file penampung. Pemilik penampung mengambil kepemilikan project skrip baru, terlepas dari siapa yang membuatnya.