Thao tác đối với Gmail

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.