Objek Action memungkinkan Anda mem-build perilaku interaktif ke dalam Add-on Google Workspace. Parameter ini menentukan
hal yang terjadi saat pengguna berinteraksi dengan widget (misalnya, tombol) di
UI add-on.
Tindakan dikaitkan ke widget tertentu menggunakan fungsi pengendali widget, yang juga menentukan kondisi yang memicu tindakan. Saat dipicu, tindakan akan menjalankan fungsi callback yang ditetapkan. Fungsi callback diberi objek peristiwa yang membawa informasi tentang interaksi sisi klien pengguna. Anda harus menerapkan fungsi callback dan memintanya menampilkan objek respons tertentu.
Misalnya, Anda menginginkan tombol yang mem-build dan menampilkan kartu baru saat
diklik. Untuk melakukannya, Anda harus membuat widget tombol baru dan menggunakan fungsi pengendali widget tombol setOnClickAction(action) untuk menyetel pembuatan kartu Action. Action
yang Anda tentukan menentukan fungsi callback Apps Script
yang dijalankan saat tombol diklik. Dalam hal ini, Anda akan menerapkan fungsi callback untuk membuat kartu yang diinginkan dan menampilkan objek ActionResponse. Objek respons memberi tahu add-on untuk menampilkan kartu fungsi callback
yang dibuat.
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 akan menampilkan |
|---|---|
| Menulis draf pesan | ComposeActionResponse |
Untuk memanfaatkan 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, membuat draf pesan di Gmail (baik pesan baru atau balasan). Untuk melakukannya, Anda harus mengaitkan widget
pemicu dengan fungsi callback yang menampilkan
objek
ComposeActionResponse. Setelah fungsi callback selesai dijalankan, Gmail akan menggunakan objek respons ini untuk membuka dan mengisi jendela penulisan draf.
Untuk mengetahui detail selengkapnya dan contoh, lihat Menulis pesan draf.