Action
对象可让您在 Google Workspace 插件中构建互动行为。它们定义了用户与插件界面中的微件(例如按钮)互动时发生的情况。
您可以使用微件处理程序函数将操作附加到指定的微件,该函数还定义触发操作的条件。触发后,操作会执行指定的回调函数。系统会向回调函数传递事件对象,其中包含有关用户客户端互动的信息。您必须实现该回调函数,并让其返回特定的响应对象。
例如,假设您想要一个按钮,点击该按钮会构建并显示新卡片。为此,您必须创建新的按钮 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 会使用此响应对象打开并填充撰写草稿的窗口。
如需了解详情并查看示例,请参阅撰写草稿消息。