Gmail 操作

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

借助 Action 对象,您可以将互动行为内置到 Google Workspace 插件中。它们定义了用户与插件界面中的 widget(例如,按钮)互动时发生的情况。

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

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

本页介绍了您可以在插件中包含的 Gmail 专用微件操作。

Gmail 互动

用于扩展 Gmail 的 Google Workspace 插件可以包含专门针对 Gmail 的额外撰写邮件的操作。此操作需要关联的操作回调函数才能返回专用响应对象:

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

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

写消息

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

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