Objek Action memungkinkan Anda membuat perilaku interaktif ke dalam add-on Google Workspace. Mereka menentukan
apa yang terjadi saat pengguna berinteraksi dengan widget (misalnya, tombol) di
UI add-on.
Tindakan dilampirkan ke widget tertentu menggunakan fungsi pengendali widget, yang juga menentukan kondisi yang memicu tindakan. Saat dipicu, tindakan akan mengeksekusi fungsi callback yang ditentukan. Fungsi callback akan menerima objek peristiwa yang membawa informasi tentang interaksi sisi klien pengguna. Anda harus menerapkan fungsi callback dan membuatnya menampilkan objek respons tertentu.
Misalnya, Anda ingin tombol yang membuat dan menampilkan kartu baru saat
diklik. Untuk melakukannya, Anda harus membuat widget tombol baru dan menggunakan fungsi handler widget tombol
setOnClickAction(action)
untuk menyetel Action pembuatan kartu. Action yang Anda tentukan menentukan fungsi callback Apps Script yang dijalankan saat tombol diklik. Dalam hal ini, Anda
menerapkan fungsi callback untuk membuat kartu yang Anda inginkan dan menampilkan
objek
ActionResponse. Objek respons memberi tahu add-on untuk menampilkan kartu yang dibuat oleh fungsi
panggilan balik.
Halaman ini menjelaskan tindakan widget khusus Gmail yang dapat Anda sertakan dalam add-on.
Interaksi Gmail
Add-on Google Workspace yang memperluas Gmail dapat menyertakan tindakan widget tambahan khusus Gmail untuk menulis pesan draf. Tindakan ini memerlukan fungsi callback tindakan terkait untuk menampilkan objek respons khusus:
| Tindakan dicoba | Fungsi callback harus menampilkan |
|---|---|
| Menulis draf pesan | ComposeActionResponse |
Untuk menggunakan tindakan widget dan objek respons ini, add-on Google Workspace harus menyertakan
https://www.googleapis.com/auth/gmail.addons.current.action.compose
cakupan dalam
manifest-nya.
Tulis pesan
Add-on yang memperluas Gmail dapat menentukan widget yang, saat berinteraksi, akan membuat draf pesan di Gmail (baik pesan baru maupun balasan). Untuk melakukannya,kaitkan widget pemicu dengan fungsi callback yang menampilkan objek
ComposeActionResponse. Setelah fungsi callback selesai dieksekusi, Gmail menggunakan
objek respons ini untuk membuka dan mengisi jendela penulisan draf.
Untuk mengetahui detail selengkapnya dan contoh, lihat Menyusun pesan draf.