Tindakan Gmail

Objek Action memungkinkan Anda membuat aplikasi perilaku pengguna yang berbeda ke Add-on Google Workspace. {i>Sprint<i} menentukan apa yang terjadi ketika pengguna berinteraksi dengan widget (misalnya, tombol) di UI add-on.

Suatu tindakan dilampirkan ke widget tertentu menggunakan fungsi pengendali widget, yang juga menentukan kondisi yang memicu tindakan. Saat dipicu, tindakan menjalankan tindakan fungsi callback. Fungsi callback diberi objek peristiwa yang membawa informasi tentang interaksi {i>client-side<i} pengguna. Anda harus menerapkan fungsi callback dan membuatnya menampilkan objek respons tertentu.

Misalnya, Anda menginginkan tombol yang membuat dan menampilkan kartu baru saat diklik. Untuk melakukannya, Anda harus membuat widget tombol baru dan menggunakan widget tombol tersebut fungsi pengendali setOnClickAction(action) untuk menetapkan Action pembuatan kartu. Tujuan Action yang Anda tentukan menentukan Apps Script fungsi callback yang dieksekusi saat tombol diklik. Dalam hal ini, Anda mengimplementasikan fungsi callback untuk membangun kartu yang Anda inginkan dan menampilkan ActionResponse . Objek respons memberi tahu add-on untuk menampilkan kartu yang akan menampilkan callback fungsi build.

Halaman ini menjelaskan tindakan widget khusus Gmail yang dapat Anda sertakan dalam {i>add-on<i}.

Interaksi Gmail

Add-on Google Workspace yang memperluas Gmail dapat mencakup tindakan widget tambahan khusus Gmail untuk menulis pesan draf. Ini memerlukan tindakan terkait fungsi callback untuk menampilkan objek respons khusus:

Tindakan dicoba Fungsi callback akan ditampilkan
Menulis draf pesan ComposeActionResponse

Untuk memanfaatkan tindakan widget dan objek respons ini, add-on harus sertakan https://www.googleapis.com/auth/gmail.addons.current.action.compose scope dalam manifesnya.

Tulis pesan

Add-on Google Workspace yang memperluas Gmail dapat menentukan widget yang, saat berinteraksi, menghasilkan draf pesan di Gmail (pesan baru atau balasan). Untuk melakukannya, Anda harus mengaitkan pemicu dengan fungsi callback yang menampilkan ComposeActionResponse . Saat fungsi callback selesai dieksekusi, Gmail akan menggunakan metode objek respons untuk membuka dan mengisi jendela tulis draf.

Untuk detail selengkapnya dan contoh, lihat Menulis draf pesan.