Thao tác đối với Gmail

Action đối tượng cho phép bạn tạo hành vi tương tác trong tiện ích bổ sung Google Workspace. Các đối tượng này 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ụ: một nút) trong giao diện người dùng của tiện ích bổ sung.

Một hành động được đính kèm vào một tiện ích nhất định bằng cách sử dụng một hàm xử lý tiện ích, hà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, hành động sẽ thực thi một hàm gọi lại được chỉ định. Hàm callback được truyền một đối tượng sự kiện mang thông tin về các lượt 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ị một thẻ mới khi nhấp vào. Để làm việc này, bạn phải tạo một tiện ích nút mới và sử dụng hàm xử lý tiện ích nút setOnClickAction(action) để đặt Action tạo thẻ. The Action mà bạn xác định sẽ chỉ định một hàm callback Apps Script thực thi khi nhấp vào nút. Trong trường hợp này, bạn triển khai hàm callback để tạo thẻ mà bạn muốn và trả về một ActionResponse đối tượng. Đối tượng phản hồi cho tiện ích bổ sung biết để hiển thị thẻ mà hàm gọi lại đã tạo.

Trang này mô tả các hành động của tiện ích dành riêng cho Gmail mà bạn có thể đưa vào tiện ích bổ sung.

Tương tác với Gmail

Các tiện ích bổ sung Google Workspace mở rộng Gmail có thể bao gồm một hành động bổ sung của tiện ích dành riêng cho Gmail để soạn thư nháp. Hành động này yêu cầu hàm callback hành động được liên kết trả về một đối tượng phản hồi chuyên biệt:

Hành động đã thử	Hàm callback phải trả về
Soạn thư nháp	ComposeActionResponse

Để sử dụng các hành động của tiện ích và đối tượng phản hồi này, tiện ích bổ sung Google Workspace 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

Các tiện ích bổ sung mở rộng Gmail có thể xác định một tiện ích mà khi tương tác, sẽ tạo thư nháp trong Gmail (thư mới hoặc thư trả lời). Để thực hiện 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ề một ComposeActionResponse đối tượng. Khi hàm callback hoàn tất việc thực thi, Gmail sẽ 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 và ví dụ, hãy xem Soạn thư nháp.