Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Các đối tượng Action cho phép bạn tạo hành vi tương tác vào các 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 của tiện ích dành riêng cho Gmail mà bạn có thể đưa vào tiện ích bổ sung.
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 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:
Để 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 vihttps://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 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.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-06-06 UTC."],[[["\u003cp\u003e\u003ccode\u003eAction\u003c/code\u003e objects enable interactive behavior in Google Workspace add-ons by defining responses to user interactions with widgets.\u003c/p\u003e\n"],["\u003cp\u003eActions are linked to widgets via handler functions and trigger callback functions that process user interactions and return response objects to update the add-on UI.\u003c/p\u003e\n"],["\u003cp\u003eGmail add-ons have a specific action for composing draft messages, requiring a \u003ccode\u003eComposeActionResponse\u003c/code\u003e object from the callback function and a specific scope in the add-on's manifest.\u003c/p\u003e\n"],["\u003cp\u003eAdd-ons can generate draft messages in Gmail by associating a widget with a callback function that returns a \u003ccode\u003eComposeActionResponse\u003c/code\u003e object, which Gmail uses to populate a draft compose window.\u003c/p\u003e\n"]]],["`Action` objects in Google Workspace add-ons enable interactive behavior. An action, triggered by a widget interaction, executes a callback function. This function receives an event object with user interaction details and returns a response object. For instance, a button click can trigger a callback to build and display a new card. Gmail add-ons can use `ComposeActionResponse` to generate draft messages, triggered by widget interaction. The add-on must include the `https://www.googleapis.com/auth/gmail.addons.current.action.compose` scope for this.\n"],null,[]]
