Skrip yang terikat penampung

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 skrip tersebut tidak muncul di Google Drive, tidak dapat dilepas dari file yang terikat dengannya, dan mendapatkan beberapa hak istimewa khusus atas file induk.

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

Catatan: Skrip terikat secara efektif tidak dipublikasikan add-on yang berfungsi hanya untuk file yang terikat dengannya.

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.

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

Metode khusus

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

• getActiveSpreadsheet(), getActiveDocument(), getActivePresentation(), dan getActiveForm() memungkinkan skrip terikat untuk merujuk ke file induknya tanpa merujuk pada ID file.
• getUi memungkinkan skrip terikat mengakses antarmuka pengguna untuk file induknya guna menambahkan menu, dialog, dan sidebar kustom.
• Di Google Spreadsheet, getActiveSheet(), getActiveRange(), dan getActiveCell() memungkinkan skrip menentukan sheet saat ini milik pengguna, rentang sel yang dipilih, atau sel individu yang dipilih. setActiveSheet(sheet) dan setActiveRange(range) mengizinkan skrip mengubah pilihan tersebut.
• Di Google Dokumen, getCursor() dan getSelection() mengizinkan skrip menentukan posisi kursor pengguna atau teks yang dipilih. setCursor(position) dan setSelection(range) mengizinkan skrip mengubah lokasi tersebut.

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

Catatan: Metode ini hanya tersedia untuk skrip terikat yang dijalankan dari editor skrip, item menu, dialog, sidebar, atau pemicu. Jika skrip terikat dijalankan sebagai aplikasi web atau melalui Apps Script API, metode ini tidak akan tersedia.

Menu, dialog, dan sidebar kustom

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

Add-on juga dapat menambahkan menu, dialog, dan sidebar kustom. Sebaiknya kembangkan add-on menggunakan skrip mandiri.

Add-on

Add-on berjalan di dalam Gmail, Google Spreadsheet, Dokumen, Slide, dan Formulir. Jika Anda telah mengembangkan skrip terikat atau mandiri dan ingin membagikannya kepada dunia, Apps Script memungkinkan Anda publish skrip sebagai add-on sehingga pengguna lain dapat menginstalnya dari toko add-on.

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 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(). Oleh karena itu, fungsi kustom mirip dengan ratusan fungsi bawaan di Spreadsheet seperti AVERAGE atau SUM kecuali Anda yang menentukan perilaku fungsi kustom tersebut.

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 serta menjalankan salinan skrip.

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

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