Skrip terikat ke file Google Spreadsheet, Dokumen, Slide, atau Formulir jika dibuat dari dokumen tersebut, bukan sebagai skrip mandiri. File tempat skrip terikat dilampirkan disebut "penampung". Skrip terikat umumnya berperilaku seperti skrip mandiri, hanya saja tidak muncul di Google Drive, file tidak dapat dilepas dari file mereka terikat, dan mereka mendapatkan beberapa hak istimewa atas file induk.
Perhatikan bahwa skrip juga dapat terikat ke Google Sites, tetapi skrip ini hampir selalu di-deploy sebagai aplikasi web. Skrip yang terikat dengan Google Spreadsheet, Dokumen, Slide, atau Formulir juga bisa menjadi aplikasi web, meskipun hal 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 Perluasan > Apps Script. Untuk membuka kembali skrip di di masa yang akan datang, lakukan hal yang sama atau buka {i>script<i} dari Dasbor Apps Script.
Google Formulir
Untuk membuat skrip terikat di Google Formulir, buka formulir lalu klik Lainnya > Skrip . Untuk membuka kembali skrip di lakukan hal yang sama atau buka skrip dari Dasbor Apps Script.
Metode khusus
Skrip terikat dapat memanggil beberapa metode yang tidak dapat dilakukan oleh skrip mandiri:
getActiveSpreadsheet()
,getActiveDocument()
,getActivePresentation()
, dangetActiveForm()
mengizinkan skrip terikat untuk merujuk ke file induknya tanpa merujuk ke ID file Anda.getUi
mengizinkan skrip terikat mengakses antarmuka pengguna untuk ditambahkan file induknya menu, dialog, dan sidebar kustom.- Di Google Spreadsheet,
getActiveSheet()
,getActiveRange()
, dangetActiveCell()
biarkan skrip menentukan {i>sheet<i} pengguna saat ini, rentang sel yang dipilih, atau sel individual yang dipilih.setActiveSheet(sheet)
dansetActiveRange(range)
membiarkan skrip mengubah pilihan tersebut. - Di Google Dokumen,
getActiveTab()
,getCursor()
, dangetSelection()
biarkan skrip menentukan tab pengguna saat ini, posisi kursor, atau teks yang dipilih.setActiveTab(tabId)
,setCursor(position)
dansetSelection(range)
membiarkan skrip mengubah pilihan tersebut.
Untuk informasi selengkapnya, lihat panduan untuk memperluas Google Spreadsheet atau panduan untuk memperluas Google Dokumen.
Menu, dialog, dan sidebar kustom
Skrip yang terikat dapat menyesuaikan Google Spreadsheet, Dokumen, dan Formulir dengan menambahkan menu kustom dan kotak dialog atau sidebar. Perlu diingat, namun, skrip hanya dapat berinteraksi dengan antarmuka pengguna untuk {i>instance <i}saat ini dari file yang terbuka. Yaitu, suatu 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 mandiri skrip dan ingin membagikannya dengan dunia, Apps Script memungkinkan Anda memublikasikan skrip Anda sebagai add-on ini sehingga pengguna lain dapat menginstalnya dari toko add-on tersebut.
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, mereka bisa
gunakan juga pemicu yang dapat diinstal.
Fungsi kustom
Fungsi kustom adalah fungsi dalam
skrip yang terikat ke Google Sheets 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 skrip walaupun jika mereka membuat salinan file container tersebut, pemilik salinan dan dapat melihat dan menjalankan salinan skrip.
Untuk mempelajari cara membagikan file penampung skrip, lihat Membagikan file dari Google Drive.