Các đối tượng Action cho phép bạn tạo hành vi tương tác trong các tiện ích bổ sung của Google Workspace. Chúng xác định những gì 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 này sẽ thực thi một hàm callback được chỉ định. 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 phía máy khách của người dùng. 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 đượ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 callback 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 sẽ triển khai hàm callback để tạo thẻ mà bạn muốn và trả về một đối tượng ActionResponse. Đối tượng phản hồi 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 cụ thể của tiện ích Gmail mà bạn có thể đưa vào tiện ích bổ sung.
Số lượt 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 callback của thao tác được liên kết trả về một đối tượng phản hồi chuyên biệt:
| Hành động đã thực hiện | Hàm callback sẽ trả về |
|---|---|
| Soạn thảo thư nháp | ComposeActionResponse |
Để sử dụng các thao tác tiện ích và đối tượng phản hồi này, tiện ích bổ sung Google Workspace phải có https://www.googleapis.com/auth/gmail.addons.current.action.compose
phạm vi trong tệp kê khai.
Soạn tin nhắn
Các tiện ích bổ sung mở rộng Gmail có thể xác định một tiện ích. Khi tương tác, tiện ích này sẽ tạo thư nháp trong Gmail (có thể là thư mới hoặc thư trả lời). Để làm việc này,hãy liên kết tiện ích kích hoạt với một hàm callback trả về đối tượng ComposeActionResponse. Khi hàm callback thực thi xong, Gmail sẽ dùng đối tượng phản hồi này để mở và điền sẵn thông tin vào 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ảo tin nhắn nháp.