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 membuat peningkatan alur kerja yang disesuaikan, membangun konektivitas ke sistem pihak ketiga, dan mengintegrasikan data Spreadsheet 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 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 serta 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 dalam 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 tempat teks, angka, link, atau nilai lainnya dapat disimpan. Sekelompok 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 menjalankan fungsi yang ditentukan 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, setiap fungsi kustom yang ditentukan dan disertakan dengan add-on akan langsung tersedia. Add-on dapat terdiri dari hanya definisi fungsi kustom. Definisi fungsi kustom umumnya dibagikan kepada orang lain dengan memublikasikan add-on yang berisi definisi tersebut.

Membuat fungsi kustom add-on

Setiap fungsi 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 diletakkan di sel Spreadsheet, yang meluap ke sel di sekitarnya sesuai kebutuhan.

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

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

  • Saat memberi nama fungsi, coba buat nama yang unik, mungkin terkait dengan nama add-on Anda. Jika dua atau beberapa add-on yang diinstal menentukan fungsi kustom dengan nama yang sama, pengguna hanya dapat menggunakan salah satunya.
  • Add-on Anda harus menyampaikan dengan jelas fungsi kustom yang disediakannya. 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 tentang 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 dalam sheet menghasilkan panggilan terpisah ke server Apps Script. Jika pengguna mencoba menggunakan fungsi kustom di terlalu banyak sel, fungsi tersebut mungkin dijalankan dengan lambat. Untuk mengurangi hal ini, buat fungsi kustom Anda sesederhana mungkin. Jika Anda memerlukan fungsi untuk melakukan pemrosesan yang kompleks atau diperpanjang, jangan gunakan fungsi kustom—berikan fungsi tersebut melalui interaksi item menu, dialog, atau sidebar.

Makro Spreadsheet

Makro memungkinkan Anda merekam tindakan yang dilakukan di Google Spreadsheet dan mengulanginya nanti dengan pintasan keyboard. Saat dibuat di sheet, makro akan ditambahkan sebagai fungsi makro dalam project Apps Script yang terikat ke sheet 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, definisi tersebut tidak akan tersedia bagi pengguna add-on tersebut.