Skrip yang terikat penampung (original) (raw)

Skrip yang terikat penampung

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Skrip terikat dengan file Google Spreadsheet, Dokumen, Slide, atau Formulir jika dibuat dari dokumen tersebut, bukan sebagai skrip mandiri. File tempat skrip terikat disebut "penampung". Skrip terikat umumnya berperilaku seperti skrip mandiri, kecuali bahwa skrip tersebut tidak muncul di Google Drive, tidak dapat dilepaskan dari file yang menjadi tempatnya terikat, dan mendapatkan beberapa hak istimewa khusus 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 ke Google Spreadsheet, Dokumen, Slide, atau Formulir juga dapat 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 Ekstensi > Apps Script. Untuk membuka kembali skrip di masa mendatang, lakukan hal yang sama atau buka skrip daridasbor 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 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 menambahkanmenu, dialog, dan sidebar kustom.
• Di Google Spreadsheet, getActiveSheet(),getActiveRange(), dan getActiveCell()memungkinkan skrip menentukan sheet pengguna saat ini, rentang sel yang dipilih, atau setiap sel yang dipilih.setActiveSheet(sheet)dan setActiveRange(range)memungkinkan skrip mengubah pilihan tersebut.
• Di Google Dokumen, getActiveTab(),getCursor(), dangetSelection()memungkinkan skrip menentukan tab pengguna saat ini, posisi kursor pengguna, atau teks yang dipilih. setActiveTab(tabId),setCursor(position), dan setSelection(range)memungkinkan skrip mengubah pilihan tersebut.

Untuk informasi selengkapnya, lihatpanduan untuk memperluas Google Spreadsheet ataupanduan untuk memperluas Google Dokumen.

Skrip terikat dapat menyesuaikan Google Spreadsheet, Dokumen, dan Formulir dengan menambahkanmenu kustom dankotak 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.

Pemicu

Skrip terikat dapat menggunakan pemicu sederhanaseperti 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 Google Spreadsheet yang Anda panggil langsung dari sel menggunakan sintaksis =myFunctionName(). Dengan demikian, fungsi kustom mirip dengan ratusanfungsi bawaan di Spreadsheet seperti AVERAGE atauSUM, kecuali Anda menentukan perilaku fungsi kustom.

Akses ke skrip terikat

Hanya pengguna yang memiliki izin untuk mengedit penampung yang dapat menjalankan skrip terikat. Kolaborator yang hanya memiliki akses lihat tidak dapat membuka editor skrip, meskipun 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 Membagikan file dari Google Drive.