Gmail 操作

借助 Action 对象,您可以为 Google Workspace 插件构建互动行为。它们定义了当用户与插件界面中的 widget(例如按钮)互动时会发生什么。

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

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

本页介绍了您可以在插件中添加的 Gmail 特有的 widget 操作。

Gmail 互动

扩展 Gmail 的 Google Workspace 加载项可以包含额外的 Gmail 特定 widget 操作,用于撰写草稿邮件。此操作要求关联的操作回调函数返回一个专用响应对象:

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

若要使用这些 widget 操作和响应对象,Google Workspace 加载项必须在其清单中包含 https://www.googleapis.com/auth/gmail.addons.current.action.compose scope

写消息

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

如需了解详情和示例,请参阅撰写草稿消息