Skrip terikat dengan file Google Spreadsheet, Dokumen, Slide, atau Formulir jika dibuat dari dokumen tersebut, bukan sebagai skrip mandiri. File tempat skrip terpasang dilampirkan disebut "container." Skrip terikat umumnya berperilaku seperti skrip mandiri, kecuali skrip tersebut tidak muncul di Google Drive, skrip tidak dapat dilepaskan dari file yang terikat, dan skrip ini mendapatkan beberapa hak istimewa khusus daripada file induk.
Perhatikan bahwa skrip juga dapat diikat ke Google Sites, tetapi skrip ini selalu di-deploy sebagai aplikasi web. Skrip yang terikat ke Spreadsheet, Dokumen, Slide, atau Formulir juga dapat menjadi aplikasi web, meskipun ini jarang terjadi.
Membuat skrip terikat
Google Dokumen, Spreadsheet, atau Slide
Untuk membuat skrip terikat di Google 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.
Google Formulir
Untuk membuat skrip terikat di Google Formulir, buka formulir dan klik Lainnya > Editor skrip. Untuk membuka kembali skrip di masa mendatang, lakukan hal yang sama atau buka skrip dari dasbor Apps Script.
Metode khusus
Skrip terikat dapat memanggil beberapa metode yang tidak dapat dilakukan skrip mandiri:
getActiveSpreadsheet()
,getActiveDocument()
,getActivePresentation()
, dangetActiveForm()
memungkinkan skrip terikat untuk merujuk ke file induknya tanpa merujuk pada ID file.getUi
memungkinkan skrip terikat mengakses antarmuka pengguna untuk file induk guna menambahkan menu, dialog, dan sidebar kustom.- Di Google Spreadsheet,
getActiveSheet()
,getActiveRange()
, dangetActiveCell()
izinkan skrip untuk menentukan sheet pengguna saat ini, rentang sel yang dipilih, atau sel individual yang dipilih.setActiveSheet(sheet)
dansetActiveRange(range)
izinkan skrip untuk mengubah pilihan tersebut. - Di Google Dokumen,
getCursor()
dangetSelection()
memungkinkan skrip menentukan posisi kursor atau teks yang dipilih milik pengguna.setCursor(position)
dansetSelection(range)
izinkan skrip untuk mengubah lokasi tersebut.
Untuk informasi selengkapnya, lihat panduan untuk memperluas Google Spreadsheet atau panduan untuk memperluas Google Dokumen.
Menu, dialog, dan sidebar kustom
Skrip terikat dapat menyesuaikan Google Spreadsheet, Dokumen, dan Formulir dengan menambahkan menu kustom dan kotak dialog atau sidebar. Namun, perhatikan bahwa skrip hanya dapat berinteraksi dengan antarmuka pengguna untuk instance file terbuka saat ini. Artinya, skrip yang terikat ke satu dokumen tidak dapat memengaruhi antarmuka pengguna dokumen lain.
Add-on
Add-on berjalan di dalam Gmail, Google Spreadsheet, Dokumen, Slide, dan Formulir. Jika Anda telah mengembangkan skrip yang terikat atau mandiri dan ingin membagikannya kepada dunia, Apps Script memungkinkan Anda memublikasikan skrip sebagai add-on sehingga pengguna lain dapat menginstalnya dari add-on store.
Triggers
Skrip terikat dapat menggunakan pemicu sederhana seperti fungsi khusus onOpen()
, yang berjalan secara otomatis setiap kali file dibuka oleh pengguna yang memiliki akses edit. Seperti semua jenis skrip, skrip juga dapat
menggunakan pemicu yang dapat diinstal.
Fungsi kustom
Fungsi kustom adalah fungsi dalam skrip yang terikat ke Google Spreadsheet yang Anda panggil langsung dari sel menggunakan sintaksis =myFunctionName()
. Dengan demikian, fungsi kustom mirip dengan ratusan
fungsi bawaan di Spreadsheet,
seperti AVERAGE
atau
SUM
, kecuali jika 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, meskipun jika mereka membuat salinan file induk, mereka menjadi pemilik salinan dan dapat melihat serta menjalankan salinan skrip.