适用于 Google Workspace 插件的触发器
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
Apps 脚本触发器触发指定的脚本
函数(即触发器函数),每当有指定事件发生时,系统即会执行该函数(即触发器函数)
。只有特定事件会触发触发器,每个
Google Workspace 应用支持一组不同的事件。
当触发器触发时,系统会创建一个事件对象。此 JSON 结构
包含发生的事件的详细信息。事件中的信息
对象结构的组织方式因触发器类型而异。
创建事件对象后,Apps 脚本会将其作为参数传递给
触发函数。触发器函数是一个回调函数,您必须
实施您自己的解决方案,以采取任何适当的措施来应对
事件。例如,在
一款可扩展 Gmail 的 Google Workspace 插件,您可以
定义一个在用户打开消息时创建新的卡片界面的触发器
线程。在这种情况下,您可以实现上下文回调函数,
构成新界面的卡片
事件对象的事件。
本页面介绍了如何在
Google Workspace
插件项目。
清单触发器
与编辑器插件不同,Google Workspace 插件
目前无法使用 Apps 脚本简单触发器
而是使用专为
Google Workspace 插件:清单触发器。
清单触发器完全在
Google Workspace 插件
manifest 的文件。清单触发器的示例包括
以下:
- 构建和显示插件首页的首页触发器。
- 日历事件打开触发器,显示新卡片或
打开日历活动时的其他操作。
- 日历 eventUpdate 触发器显示新卡片或
用户编辑和保存日历活动时的其他操作。
- 云端硬盘 onItemsSelected 触发器,用于显示新卡片或呈现新内容
当用户选择云端硬盘中的一个或多个文件或文件夹时,还会执行其他操作。
- Gmail 撰写触发器:当
用户在 Gmail 撰写窗口中打开插件。
- Gmail 内容相关触发器,用于显示新卡片或使用其他
在用户打开 Gmail 邮件时执行的操作。
- Editor onFileScopeGranted 触发器在用户执行操作时显示新卡片
在当前编辑器中为
drive.file
OAuth 范围授权
文档。
在上面的列表中,只有首页触发器与上下文无关;其余的
情境触发器。请参阅清单
。
除了清单触发器之外,Google Workspace
插件也可以使用 Apps 脚本
可安装触发器。
限制
清单触发器在使用方面存在一定限制。
- 这些触发器仅用于 Google Workspace 插件项目;它们在任何其他应用中都没有任何用途
- 由于它们是在插件清单中(而非其代码)中定义的,因此您无法
使用 Apps 脚本
Script
来创建或修改这些触发器。
- Gmail 内容相关触发器目前只能有一个
unconditional
条件。
这意味着系统会为每封电子邮件触发上下文触发器,无论
内容。
- 对于每位用户的每个文档,每个插件只能有一个针对每种类型的触发器。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-09-02。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"没有我需要的信息"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"太复杂/步骤太多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"内容需要更新"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻译问题"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/代码问题"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"易于理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"解决了我的问题"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
{"lastModified": "\u6700\u540e\u66f4\u65b0\u65f6\u95f4 (UTC)\uff1a2024-09-02\u3002"}
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2024-09-02。"]]