限制

扩展程序的功能受到一些限制。请避免这些陷阱,以提升用户的整体体验。

一般限制

以下限制适用于所有插件。请勿执行以下操作:

更改 Google Workspace 中的功能

插件框架旨在增强 Google Workspace 应用,而不是增加限制。因此,您无法更改现有功能或锁定 Google Workspace 文档共享模式。

向用户收取安装费用

我们不提供向用户收取安装插件费用的方法,并且插件不得包含广告。不过,您可以自行构建付款系统,也可以调用现有结算数据库。您的插件可以连接到向用户收费的非 Google 服务。

检测许多事件

除了某些触发器外,插件无法得知用户在插件本身之外执行了哪些操作。例如,您无法检测用户何时点击宿主应用工具栏。您可以通过边栏的客户端代码轮询文件内容的更改,但始终会存在轻微延迟。

Google Workspace 插件

以下限制仅适用于 Google Workspace 插件和卡片服务的使用。请勿执行以下操作:

扩展所有 Google Workspace 应用

Google Workspace 插件只能扩展 Gmail、日历、云端硬盘、文档、表格和幻灯片。最终,Google Workspace 插件将能够扩展其他 Google Workspace 应用。

云端硬盘中的情境触发

Google Workspace 插件只能在阅读或撰写邮件时为 Gmail 提供上下文触发,在日历中则只能在打开活动时提供上下文触发。尚不支持针对云端硬盘文件触发情境启动。请参阅临时开发实践

编辑器中的文档上下文

Google Workspace 插件尚不支持在编辑器中使用文档上下文。也就是说,您无法使用 SpreadsheetApp.getActiveSpreadsheet() 等方法获取当前文档。请参阅临时开发实践

使用 HTML/CSS 或客户端脚本

Google Workspace 插件必须使用基于卡片的界面。无法使用编辑器插件支持的 HTML/CSS 接口。Google Workspace 插件使用基于 widget 的方法构建界面。这样,该插件便可在桌面平台和移动平台上正常运行,而无需您为每种平台分别构建界面。

全面支持移动设备

目前,Google Workspace 插件可在桌面版 Web 客户端上运行。移动版 Gmail 应用也支持基于上下文的触发(即 Gmail 邮件阅读)。移动版 Gmail、日历或云端硬盘应用尚不支持非基于上下文的首页。移动网络浏览器不支持 Google Workspace 插件。

使用 Apps 脚本触发器

您无法在 Google Workspace 插件中创建或使用 Apps 脚本简单触发器

使用 SVG 图片

您目前无法将 SVG 图片与卡片服务卡片和 widget 搭配使用。

包含超过 100 个微件

出于性能方面的原因,您无法向一张卡片添加超过 100 个微件或 100 个卡片部分。