Melengkapi 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 meningkatkan kualitas alur kerja yang disesuaikan, membuat 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 telah dibuat orang lain di Google Workspace Marketplace.

Yang dapat Anda lakukan

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

  • Anda dapat membaca, mengedit, memvisualisasikan, dan memformat data di spreadsheet Google Spreadsheet menggunakan layanan Spreadsheet Apps Script bawaan. Layanan ini juga memungkinkan Anda membuat dan mengubah format bersyarat dan aturan validasi data.
  • Anda dapat menggunakan layanan Spreadsheet lanjutan Apps Script untuk mengakses Google Sheets API secara langsung.
  • Anda dapat membuat menu kustom dan menentukan beberapa antarmuka dialog dan sidebar kustom menggunakan HTML dan CSS standar.
  • Anda dapat menyertakan definisi fungsi kustom di add-on.
  • Anda dapat 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 Google Spreadsheet dengan Apps Script, lihat Memperluas Google Spreadsheet.

Struktur sheet

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

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

Pemicu

Pemicu Apps Script memungkinkan project skrip mengeksekusi 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

Google Spreadsheet memiliki sejumlah fungsi bawaan seperti SUM dan AVERAGE yang dapat dipanggil dari dalam sel Google 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 terdiri dari hanya 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 = yang diikuti dengan nama fungsi dan parameter yang diperlukan. Jika tidak ada error, hasil yang ditampilkan oleh fungsi akan ditempatkan di sel Spreadsheet, meluap ke sel di sekitarnya jika perlu.

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

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

  • Saat memberi nama fungsi, coba buat nama yang unik, mungkin terkait dengan nama add-on Anda. Jika dua add-on atau lebih yang diinstal menentukan fungsi kustom dengan nama yang sama, pengguna hanya dapat menggunakan salah satunya.
  • Add-on Anda harus secara jelas menyampaikan fungsi kustom yang disediakan. Pastikan untuk memberikan komentar JSDoc yang akurat untuk fungsi kustom Anda agar Apps Script dapat menyajikan informasi isi otomatis kepada pengguna. Selain itu, pertimbangkan untuk memberikan dokumentasi tambahan tentang fungsi kustom baik di add-on itu sendiri maupun 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 dalam spreadsheet menghasilkan panggilan terpisah ke server Apps Script. Jika pengguna mencoba menggunakan fungsi kustom di terlalu banyak sel, fungsi mungkin berjalan lambat. Untuk memitigasi hal ini, buat fungsi kustom Anda sesederhana mungkin. Jika Anda memerlukan fungsi untuk melakukan pemrosesan yang kompleks atau diperpanjang, jangan gunakan fungsi kustom—sediakan fungsi tersebut melalui item menu, dialog, atau interaksi sidebar.

Makro Spreadsheet

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

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