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