Objek Action memungkinkan Anda membuat perilaku
interaktif ke dalam add-on Google Workspace. Fungsi ini 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 ini akan mengeksekusi fungsi callback yang ditetapkan. Fungsi callback diteruskan objek peristiwa yang membawa informasi tentang interaksi sisi klien pengguna. Anda harus mengimplementasikan 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 pengendali widget tombol setOnClickAction(action) untuk menetapkan 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 diinginkan dan menampilkan
objek
ActionResponse. Objek respons memberi tahu add-on untuk menampilkan kartu yang dibuat fungsi callback.
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 khusus Gmail tambahan untuk menulis pesan draf. Tindakan ini memerlukan fungsi callback tindakan terkait untuk menampilkan objek respons khusus:
| Tindakan dicoba | Fungsi callback harus menampilkan |
|---|---|
| Menulis pesan draf | ComposeActionResponse |
Untuk menggunakan tindakan widget dan objek respons ini, add-on harus
menyertakan
cakupan
https://www.googleapis.com/auth/gmail.addons.current.action.compose dalam manifesnya.
Tulis pesan
Add-on Google Workspace yang memperluas Gmail dapat menentukan widget yang, saat berinteraksi, menghasilkan pesan draf di Gmail (baik pesan baru maupun balasan). Untuk melakukannya, Anda harus mengaitkan widget pemicu
dengan fungsi callback yang menampilkan
objek
ComposeActionResponse. Saat fungsi callback selesai dieksekusi, Gmail menggunakan objek respons ini untuk membuka dan mengisi jendela tulis draf.
Untuk mengetahui detail selengkapnya dan contoh, lihat Pesan draf Compose.