Pemicu untuk Add-on Google Workspace

Pemicu Apps Script menyebabkan fungsi skrip tertentu (fungsi pemicu) dijalankan setiap kali peristiwa tertentu terjadi. Hanya peristiwa tertentu yang dapat menyebabkan pemicu diaktifkan, dan setiap aplikasi Google Workspace mendukung kumpulan peristiwa yang berbeda.

Saat pemicu diaktifkan, objek peristiwa akan dibuat. Struktur JSON ini berisi detail tentang peristiwa yang terjadi. Informasi dalam struktur objek peristiwa diatur secara berbeda berdasarkan jenis pemicu.

Setelah objek peristiwa dibuat, Apps Script akan meneruskannya sebagai parameter ke fungsi pemicu. Fungsi pemicu adalah fungsi callback yang harus Anda terapkan sendiri, untuk mengambil tindakan apa pun yang sesuai untuk merespons peristiwa tersebut. Misalnya, di Add-on Google Workspace yang memperluas Gmail, Anda dapat menentukan pemicu yang membuat antarmuka kartu baru saat pengguna membuka thread pesan. Dalam hal ini, Anda akan menerapkan fungsi callback kontekstual untuk membuat kartu yang membentuk UI baru menggunakan data yang diteruskan objek peristiwa.

Halaman ini memberikan panduan tentang penggunaan pemicu dalam project add-on Google Workspace.

Pemicu manifes

Tidak seperti Add-on Editor, Add-on Google Workspace saat ini tidak dapat menggunakan pemicu sederhana Apps Script. Sebagai gantinya, Add-on tersebut menggunakan pemicu yang dirancang khusus untuk Add-on Google Workspace: pemicu manifes.

Pemicu manifes ditentukan sepenuhnya dalam manifes Add-on Google Workspace. Contoh pemicu manifes mencakup hal berikut:

  • Pemicu halaman beranda yang membuat dan menampilkan halaman beranda add-on.
  • Acara kalender Pemicu terbuka yang menampilkan kartu baru atau melakukan tindakan lain saat acara Kalender dibuka.
  • Pemicu update acara Kalender yang menampilkan kartu baru atau melakukan tindakan lain saat pengguna mengedit dan menyimpan acara Kalender.
  • Pemicu onItemsSelected Drive yang menampilkan kartu baru atau melakukan tindakan lain saat pengguna memilih satu atau beberapa file atau folder di Drive.
  • Pemicu penulisan Gmail yang menampilkan kartu add-on saat pengguna membuka add-on di jendela tulis Gmail.
  • Pemicu kontekstual Gmail yang menampilkan kartu baru atau melakukan tindakan lain saat pengguna membuka pesan Gmail.
  • Pemicu onFileScopeGranted Editor yang menampilkan kartu baru saat pengguna memberikan otorisasi untuk cakupan OAuth drive.file di dokumen Editor saat ini.

Dalam daftar di atas, hanya pemicu halaman beranda yang tidak kontekstual; sisanya adalah pemicu kontekstual. Lihat Manifes untuk mengetahui informasi selengkapnya tentang definisi pemicu manifes.

Selain pemicu manifes, add-on Google Workspace juga dapat menggunakan pemicu yang dapat diinstal Apps Script.

Batasan

Pemicu manifes memiliki batasan tertentu pada penggunaannya.

  • Pemicu ini hanya digunakan di project Add-on Google Workspace. Pemicu ini tidak memiliki kegunaan di aplikasi lain.
  • Karena ditentukan dalam manifes add-on dan bukan dalam kodenya, Anda tidak dapat menggunakan layanan Script Apps Script untuk membuat atau mengubah pemicu ini.
  • Pemicu kontekstual Gmail saat ini hanya dapat memiliki kriteria unconditional. Ini berarti pemicu kontekstual diaktifkan untuk setiap pesan email, apa pun kontennya.
  • Setiap add-on hanya dapat memiliki satu pemicu untuk setiap jenis, per pengguna, per dokumen.