Gmail 操作

Action 对象可让您在 Google Workspace 插件中构建互动行为。它们定义了当用户与插件界面中的微件（例如按钮）互动时会发生什么情况。

操作使用 微件处理程序函数附加到给定微件， 该函数还定义了触发操作的条件。触发后， 操作会执行指定的 回调函数。 系统会将一个 事件对象传递给回调函数，该对象包含 有关用户客户端互动的信息。您必须实现回调函数，并让其返回特定的响应对象。

例如，假设您想要一个按钮，点击后可以构建并显示新卡片。为此，您必须创建一个新的按钮微件，并使用按钮微件 处理程序函数 setOnClickAction(action) 设置一个卡片构建 Action。您定义的 Action指定了一个在点击按钮时执行的 Apps 脚本 回调函数。在这种情况下，您可以 实现回调函数来构建所需的卡片并返回一个 ActionResponse 对象。响应对象会告知插件显示回调函数构建的卡片。

本页介绍了您可以添加到插件中的 Gmail 特定的微件操作。

Gmail 互动

扩展 Gmail 的 Google Workspace 插件可以包含一个额外的 Gmail 特定的微件操作，用于撰写草稿邮件。此操作需要关联的操作回调函数返回一个专用响应对象：

尝试执行的操作	回调函数应返回
撰写草稿邮件	ComposeActionResponse

如需使用这些微件操作和响应对象， Google Workspace 插件必须在其 https://www.googleapis.com/auth/gmail.addons.current.action.compose 清单中包含 范围。

写消息

扩展 Gmail 的插件可以定义一个微件，当用户与该微件互动时，系统会在 Gmail 中生成草稿邮件（新邮件或回复）。为此，您需要将触发微件与返回 ComposeActionResponse 对象的关联回调函数相关联。当回调函数执行完毕后，Gmail 会使用此响应对象打开并填充草稿撰写窗口。

如需了解详情和示例，请参阅 撰写草稿邮件。