Các đối tượng Action cho phép bạn tạo các lớp có tính tương tác
hành vi vào Tiện ích bổ sung của Google Workspace. Chúng xác định
điều gì xảy ra khi người dùng tương tác với một tiện ích (ví dụ: một nút) trong
giao diện người dùng tiện ích bổ sung.
Một hành động được đính kèm vào một tiện ích cụ thể bằng một hàm trình xử lý tiện ích, mã này cũng xác định điều kiện kích hoạt hành động đó. Khi được kích hoạt, sẽ thực thi một hành động đã chỉ định. callback function (hàm callback). Hàm callback được truyền một đối tượng sự kiện mang thông tin về các hoạt động tương tác của người dùng ở phía máy khách. Bạn phải triển khai hàm callback và yêu cầu hàm này trả về một đối tượng phản hồi cụ thể.
Ví dụ: giả sử bạn muốn một nút tạo và hiển thị thẻ mới khi
đã nhấp vào. Để thực hiện điều này, bạn phải tạo một tiện ích nút mới và sử dụng tiện ích nút
hàm trình xử lý
setOnClickAction(action)
để thiết lập Action tạo thẻ. Chiến lược phát hành đĩa đơn
Action mà bạn xác định sẽ chỉ định một Apps Script
hàm callback thực thi khi người dùng nhấp vào nút này. Trong trường hợp này, bạn
triển khai hàm callback để tạo thẻ bạn muốn và trả về một
ActionResponse
. Đối tượng phản hồi yêu cầu tiện ích bổ sung hiển thị thẻ lệnh gọi lại
tạo.
Trang này mô tả các thao tác dành riêng cho tiện ích của Gmail mà bạn có thể đưa vào tiện ích bổ sung.
Số lần tương tác với Gmail
Các tiện ích bổ sung của Google Workspace giúp mở rộng Gmail có thể bao gồm một thao tác tiện ích bổ sung dành riêng cho Gmail để soạn thư nháp. Chiến dịch này hành động cần thực hiện hành động liên quan hàm callback để trả về một đối tượng phản hồi chuyên biệt:
| Đã cố gắng thực hiện thao tác | Hàm gọi lại cần trả về |
|---|---|
| Soạn thư nháp | ComposeActionResponse |
Để tận dụng các thao tác và đối tượng phản hồi này trên tiện ích, tiện ích bổ sung phải
bao gồm
https://www.googleapis.com/auth/gmail.addons.current.action.compose
scope trong tệp kê khai.
Soạn tin nhắn
Tiện ích bổ sung của Google Workspace giúp mở rộng Gmail
xác định tiện ích sẽ tạo thư nháp trong Gmail khi được tương tác
(tin nhắn mới hoặc tin nhắn trả lời). Để làm điều này, bạn phải liên kết yếu tố kích hoạt
tiện ích có hàm callback trả về một
ComposeActionResponse
. Khi hàm callback hoàn tất, Gmail sẽ sử dụng giá trị này
để mở và điền sẵn cửa sổ soạn thư nháp.
Để biết thêm chi tiết và ví dụ, hãy xem Soạn thư nháp.