Pemicu untuk Add-on Google Workspace

Pemicu Apps Script menyebabkan skrip tertentu fungsi (fungsi pemicu) untuk dieksekusi setiap kali peristiwa yang ditentukan apa yang terjadi. Hanya peristiwa tertentu yang dapat menyebabkan pemicu diaktifkan, dan setiap peristiwa Aplikasi Google Workspace mendukung berbagai peristiwa.

Saat pemicu diaktifkan, objek peristiwa akan dibuat. Struktur JSON ini berisi detail tentang peristiwa yang terjadi. Informasi dalam peristiwa struktur objek disusun 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 menanggapi peristiwa. Misalnya, di Add-on Google Workspace yang memperluas Gmail, Anda dapat tentukan pemicu yang membuat antarmuka kartu baru bila pengguna membuka pesan . Dalam hal ini, Anda menerapkan fungsi callback kontekstual untuk membuat kartu yang membentuk UI baru menggunakan data yang diteruskan dalam objek peristiwa.

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

Pemicu manifes

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

Pemicu manifes didefinisikan sepenuhnya di dalam Add-on Google Workspace manifes. Contoh pemicu manifes mencakup berikut ini:

  • Pemicu halaman beranda yang membuat dan menampilkan halaman beranda add-on.
  • Pemicu acara Kalender yang menampilkan kartu baru atau pengambilan tindakan lainnya saat acara Kalender dibuka.
  • Pemicu acaraUpdate Kalender yang menampilkan kartu atau pengambilan baru tindakan lainnya saat pengguna mengedit dan menyimpan acara Kalender.
  • Pemicu onItemsSelected Drive yang menampilkan kartu atau pengambilan baru tindakan lainnya 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 mengambil tindakan saat pengguna membuka pesan Gmail.
  • Pemicu Editor onFileScopeGranted yang menampilkan kartu baru saat pengguna berikan otorisasi untuk cakupan OAuth drive.file di Editor saat ini dokumen.

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, Google Workspace add-on juga dapat menggunakan Apps Script pemicu yang dapat diinstal.

Pembatasan

Pemicu manifes memiliki batasan tertentu pada penggunaannya.

  • Pemicu ini hanya digunakan di project Add-on Google Workspace; mereka tidak memiliki tujuan di aplikasi lain.
  • Karena didefinisikan di manifes add-on dan bukan di dalam kode, Anda tidak dapat menggunakan Apps Script 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, terlepas dari saat ini.
  • Setiap add-on hanya dapat memiliki satu pemicu dari setiap jenis, per pengguna, per dokumen.