Thao tác đối với Gmail

Đối tượng Action cho phép bạn xây dựng hành vi tương tác vào Tiện ích bổ sung của Google Workspace. Chúng 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ụ: một 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, 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 chứa thông tin về 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 xử lý tiện ích nút setOnClickAction(action) để đặt Action tạo thẻ. Action mà bạn đã xác định sẽ chỉ định hàm callback Apps Script sẽ 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 sẽ triển khai hàm callback để tạo thẻ 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 hành động trên tiện ích dành riêng cho Gmail mà bạn có thể đưa vào tiện ích bổ sung của mình.

Lượt tương tác với Gmail

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. Thao tác này cần có hàm gọi lại (callback) đối với thao tác liên kết để trả về một đối tượng phản hồi chuyên biệt:

Hành động đã cố gắng thực hiện Hàm callback sẽ trả về
Soạn thư nháp ComposeActionResponse

Để tận dụng các thao tác trong tiện ích và đối tượng phản hồi này, tiện ích bổ sung phải đưa phạm vi https://www.googleapis.com/auth/gmail.addons.current.action.compose vào tệp kê khai.

Soạn tin nhắn

Một tiện ích bổ sung của Google Workspace giúp mở rộng Gmail có thể xác định một tiện ích sẽ tạo ra thư nháp trong Gmail (thư hoặc thư trả lời mới khi được tương tác). Để thực hiện 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 callback có nhiệm vụ 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 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.