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 membangun 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 adalah 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 dalam add-on.
  • Anda dapat menggunakan pemicu add-on yang menjalankan fungsi tertentu saat terjadi peristiwa pemicu tertentu.

Add-on Spreadsheet dibuat menggunakan Apps Script. Untuk mempelajari cara mengakses dan mengelola Google Spreadsheet dengan Apps Script lebih lanjut, 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 lain 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 dan perilaku Spreadsheet.

Pemicu

Pemicu Apps Script memungkinkan project skrip menjalankan fungsi yang ditentukan ketika 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 segera tersedia. Add-on dapat berisi definisi fungsi kustom saja. Definisi fungsi kustom umumnya dibagikan kepada orang lain dengan memublikasikan add-on yang berisi definisi.

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: dalam sel Sheet, masukkan = diikuti dengan nama fungsi dan parameter yang diperlukan. Jika tidak ada error, hasil yang ditampilkan oleh fungsi akan ditempatkan dalam sel Sheet, dan melebihi sel di sekitarnya sesuai kebutuhan.

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

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 atau beberapa add-on yang terinstal menetapkan fungsi kustom dengan nama yang sama, pengguna hanya dapat menggunakan salah satunya.
  • Add-on Anda harus menyampaikan dengan jelas fungsi kustom yang disediakannya. Pastikan Anda memberikan komentar JSDoc yang akurat untuk fungsi kustom Anda, sehingga Apps Script dapat memberikan informasi pelengkapan otomatis kepada pengguna. Selain itu, pertimbangkan untuk memberikan dokumentasi tambahan tentang fungsi kustom baik 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. Bangun pengalaman pengguna yang baik dengan membatasi jumlah pemrosesan yang Anda lakukan dalam fungsi kustom. Optimalkan fungsi sebisa mungkin.
  • 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 akan menghasilkan panggilan terpisah ke server Apps Script. Jika pengguna mencoba menggunakan fungsi kustom di terlalu banyak sel, fungsi tersebut dapat dijalankan dengan lambat. Untuk mengurangi hal ini, buat fungsi kustom Anda sesederhana mungkin. Jika Anda memerlukan fungsi tersebut untuk melakukan pemrosesan yang kompleks atau diperluas, jangan gunakan fungsi kustom—berikan 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 dibuat dalam sheet, makro akan ditambahkan sebagai fungsi makro dalam project Apps Script yang terikat dengan sheet tersebut. Untuk 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.