Memperluas Google Spreadsheet dengan add-on

Google Spreadsheet adalah solusi spreadsheet berbasis cloud dengan kolaborasi real-time dan alat canggih untuk memvisualisasikan, memproses, dan mengomunikasikan data.

Anda dapat memperluas Spreadsheet dengan add-on yang membuat peningkatan alur kerja yang disesuaikan, membangun konektivitas ke sistem pihak ketiga, dan mengintegrasikan data Spreadsheet Anda dengan aplikasi Google Workspace lainnya (seperti Google Slide).

Anda dapat melihat add-on Spreadsheet yang dibuat orang lain di Google Workspace Marketplace.

Yang dapat Anda lakukan

Berikut beberapa hal yang dapat Anda lakukan dengan add-on yang memperluas Spreadsheet:

• Membaca, mengedit, memvisualisasikan, dan memformat data dalam spreadsheet Spreadsheet menggunakan Apps Script bawaan layanan Spreadsheet. Layanan ini juga memungkinkan Anda membuat dan mengubah aturan validasi data dan pemformatan bersyarat.
• Menggunakan layanan Spreadsheet lanjutan Apps Script untuk mengakses Google Sheets API secara langsung.
• Membuat menu kustom dan menentukan beberapa antarmuka dialog dan sidebar kustom menggunakan HTML dan CSS standar.
• Menyertakan definisi fungsi kustom di add-on Anda.
• Menggunakan pemicu add-on yang menjalankan fungsi tertentu saat peristiwa pemicu tertentu terjadi.

Add-on Spreadsheet dibuat menggunakan Apps Script. Untuk mempelajari lebih lanjut cara mengakses dan mengelola Spreadsheet dengan Apps Script, lihat Memperluas Spreadsheet.

Struktur spreadsheet

Spreadsheet Spreadsheet terdiri dari satu atau beberapa spreadsheet. Setiap spreadsheet pada dasarnya adalah petak sel 2D yang dapat menyimpan teks, angka, link, atau nilai lainnya. Sekelompok satu atau beberapa sel yang berdekatan disebut rentang.

Layanan Spreadsheet Apps Script menyediakan beberapa class untuk mewakili struktur organisasi di Spreadsheet (seperti Sheet dan Range). Anda dapat menggunakan class ini untuk membaca dan mengubah data dan perilaku Spreadsheet.

Pemicu

Pemicu Apps Script memungkinkan project skrip menjalankan fungsi tertentu saat kondisi tertentu terpenuhi, seperti saat spreadsheet dibuka atau saat add-on diinstal.

Lihat pemicu add-on untuk mengetahui informasi selengkapnya tentang pemicu yang dapat digunakan dengan add-on Spreadsheet dan batasan yang berlaku untuk penggunaannya.

Fungsi kustom

Spreadsheet memiliki sejumlah fungsi bawaan seperti SUM dan AVERAGE yang dapat dipanggil dari dalam sel Spreadsheet. Add-on Spreadsheet dapat menentukan fungsi kustom tambahan untuk melengkapi fungsi bawaan ini. Saat pengguna menginstal add-on, fungsi kustom yang ditentukan dan disertakan dengan add-on akan langsung tersedia. Add-on dapat hanya terdiri dari definisi fungsi kustom. Definisi fungsi kustom terutama dibagikan kepada orang lain dengan memublikasikan add-on yang berisi definisi tersebut.

Membuat fungsi kustom add-on

Fungsi apa pun yang ditentukan dalam project skrip add-on dapat digunakan sebagai fungsi kustom. Setelah fungsi diterapkan dan add-on diinstal, Anda dapat memanggil fungsi kustom seperti fungsi Spreadsheet bawaan lainnya: di sel Spreadsheet, masukkan = diikuti dengan nama fungsi dan parameter yang diperlukan. Jika tidak ada error, hasil yang ditampilkan oleh fungsi akan ditempatkan di sel Spreadsheet, dan meluap ke sel tetangga jika diperlukan.

Saat membuat fungsi kustom di add-on, Anda harus mengikuti panduan fungsi kustom umum:

• Panduan penamaan fungsi
• Menentukan argumen fungsi
• Menentukan nilai yang ditampilkan fungsi
• Jenis data fungsi kustom
• Mengaktifkan pelengkapan otomatis menggunakan JSDoc
• Layanan yang dapat digunakan fungsi kustom
• Mengoptimalkan fungsi kustom

Selain itu, fungsi kustom yang ditentukan dalam add-on memiliki beberapa pertimbangan khusus:

• Saat memberi nama fungsi, coba buat nama yang unik, yang mungkin terkait dengan nama add-on Anda. Jika dua atau lebih add-on yang diinstal menentukan fungsi kustom dengan nama yang sama, pengguna hanya dapat menggunakan salah satunya.
• Add-on Anda harus mengomunikasikan dengan jelas fungsi kustom yang disediakan. Pastikan untuk memberikan komentar JSDoc yang akurat untuk fungsi kustom Anda sehingga Apps Script dapat menampilkan informasi pelengkapan otomatis kepada pengguna. Selain itu, pertimbangkan untuk memberikan dokumentasi tambahan fungsi kustom di add-on itu sendiri atau di halaman web dukungan add-on.
• Fungsi kustom yang tidak selesai dalam waktu kurang dari 30 detik akan gagal dengan error Internal error executing the custom function. Buat pengalaman pengguna yang baik dengan membatasi jumlah pemrosesan yang Anda lakukan dalam fungsi kustom. Optimalkan fungsi jika memungkinkan.
• Fungsi kustom tidak dapat menggunakan layanan Apps Script yang memerlukan otorisasi, dan akan gagal dengan error You do not have permission to call X service jika hal ini dicoba. Hanya gunakan layanan yang diizinkan dalam fungsi kustom Anda.
• Setiap fungsi kustom di Spreadsheet akan menghasilkan panggilan terpisah ke server Apps Script. Jika pengguna mencoba menggunakan fungsi kustom di terlalu banyak sel, fungsi dapat berjalan lambat. Untuk mengatasinya, buat fungsi kustom Anda sesederhana mungkin. Jika Anda memerlukan fungsi untuk melakukan pemrosesan yang kompleks atau diperpanjang, jangan gunakan fungsi kustom. Berikan fungsi tersebut menggunakan item menu, dialog, atau interaksi sidebar.

Makro Spreadsheet

Makro memungkinkan Anda merekam tindakan yang dilakukan di Spreadsheet dan mengulanginya nanti dengan pintasan keyboard. Saat makro dibuat di Spreadsheet, makro akan ditambahkan sebagai fungsi makro dalam project Apps Script yang terikat ke Spreadsheet tersebut. Untuk mengetahui informasi selengkapnya tentang makro, lihat Makro Spreadsheet.

Sayangnya, makro Spreadsheet tidak dapat didistribusikan dengan add-on. Jika Anda menyertakan definisi makro dalam manifes add-on, makro tersebut tidak akan tersedia untuk pengguna add-on tersebut.