Melengkapi Google Spreadsheet dengan add-on

Google Spreadsheet adalah software berbasis cloud solusi {i>spreadsheet <i}dengan kolaborasi real-time dan alat canggih untuk memvisualisasikan, memproses, dan mengkomunikasikan data.

Anda dapat memperluas Spreadsheet dengan {i> add-on<i} yang membuat peningkatan alur kerja khusus, 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 telah 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 Sheets:

  • Anda dapat membaca, mengedit, memvisualisasikan, dan memformat data di spreadsheet Google Spreadsheet menggunakan Apps Script bawaan Layanan spreadsheet. Layanan ini juga memungkinkan Anda membuat dan mengubah data serta format bersyarat aturan validasi.
  • Anda dapat menggunakan layanan Spreadsheet lanjutan Apps Script untuk mengakses Google Sheets API secara langsung.
  • Anda dapat membuat menu khusus dan menetapkan beberapa dialog kustom dan sidebar antarmuka menggunakan HTML dan CSS standar.
  • Anda dapat menyertakan definisi fungsi kustom dalam {i>add-on<i}.
  • 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 tentang 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 {i>sheet<i} adalah pada dasarnya kisi-kisi sel 2D menjadi tempat teks, angka, tautan, atau dapat disimpan. Sekelompok dari satu atau lebih 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 untuk membaca dan mengubah data dan perilaku Spreadsheet.

Pemicu

Pemicu Apps Script mengizinkan project skrip mengeksekusi suatu fungsi tertentu ketika kondisi tertentu terpenuhi, seperti ketika sebuah {i>spreadsheet<i} dibuka atau ketika add-on diinstal.

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

Fungsi kustom

Google Sheets memiliki sejumlah fungsi bawaan seperti SUM dan AVERAGE yang dapat dipanggil dari dalam sel Spreadsheet Google. Add-on Spreadsheet dapat menentukan fungsi kustom untuk melengkapi fungsi bawaan. Saat pengguna akan menginstal add-on, fungsi khusus apa pun yang ditentukan yang disertakan dengan add-on segera tersedia. Add-on dapat terdiri dari definisi fungsi kustom saja. Definisi fungsi kustom utamanya dibagikan kepada orang lain dengan memublikasikan add-on yang berisi definisi.

Membuat fungsi kustom add-on

Setiap fungsi yang ditentukan dalam project skrip add-on dapat digunakan sebagai fungsi tersebut. Setelah fungsi diimplementasikan dan add-on diinstal, Anda dapat memanggil fungsi khusus seperti fungsi Spreadsheet bawaan lainnya: di Sel sheet, masukkan = diikuti dengan nama fungsi dan karakter apa pun yang diperlukan parameter. Jika tidak ada error, hasil yang ditampilkan oleh fungsi tersebut adalah ditempatkan di sel {i>Sheet<i}, sehingga meluber ke sel di sekitarnya sesuai kebutuhan.

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

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

  • Saat memberi nama fungsi, cobalah membuat nama unik, mungkin terkait dengan nama add-on Anda. Jika dua atau lebih add-on terinstal menentukan fungsi dengan nama yang sama, pengguna hanya dapat menggunakan salah satunya.
  • Add-on Anda harus mengomunikasikan fungsi kustom yang disediakannya dengan jelas. Pastikan untuk memberikan komentar JSDoc yang akurat untuk fungsi khusus Anda sehingga Apps Script dapat menyajikan informasi pelengkapan otomatis kepada pengguna. Selain itu, pertimbangkan untuk memberikan dokumentasi tambahan mengenai 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 Internal error executing the custom function error. Membangun pengguna yang baik pengalaman pengguna dengan membatasi jumlah pemrosesan yang Anda lakukan dalam fungsi kustom. Mengoptimalkan fungsi sebisa mungkin.
  • Fungsi kustom tidak dapat menggunakan layanan Apps Script yang memerlukan otorisasi, dan gagal dengan error You do not have permission to call X service jika dilakukan. Hanya gunakan layanan yang diizinkan dalam fungsi kustom.
  • Setiap fungsi kustom dalam sheet menghasilkan panggilan terpisah ke Apps Script server web. Jika pengguna mencoba menggunakan fungsi khusus di terlalu banyak sel, fungsi dapat dieksekusi dengan lambat. Untuk mengurangi hal ini, pertahankan fungsi kustom Anda menjadi sesederhana mungkin. Jika Anda memerlukan fungsi untuk melakukan jangan gunakan fungsi kustom—berikan fungsi tersebut melalui item menu, dialog, atau interaksi sidebar.

Makro Spreadsheet

Makro memungkinkan Anda merekam tindakan diambil di Google Sheets dan mengulanginya dengan menggunakan pintasan {i>keyboard<i}. Ketika seorang makro dibuat dalam sheet, lalu akan ditambahkan sebagai fungsi makro di tab Project skrip terikat ke sheet tersebut. Untuk selengkapnya informasi tentang makro, lihat Makro Google Spreadsheet.

Sayangnya, makro Spreadsheet tidak dapat didistribusikan dengan add-on. Jika Anda menyertakan definisi makro di manifes add-on, maka tidak tersedia bagi pengguna {i>add-on<i}.