通过插件扩展 Google 表格的功能

Google 表格是一种 基于云端的电子表格解决方案,具有实时协作功能和强大的 工具,可用于直观呈现、处理和传递数据。

您可以使用插件扩展 Google 表格的功能,以构建自定义工作流改进方案、建立与第三方系统的连接,并将 Google 表格数据与其他 Google Workspace 应用(例如 Google 幻灯片)集成。

您可以在 Google Workspace Marketplace 中查看其他人构建的 Google 表格插件。

可以采取的措施

以下是您可以使用扩展 Google 表格的插件执行的一些操作:

Google 表格插件是使用 Apps 脚本构建的。如需详细了解如何使用 Apps 脚本访问和管理 Google 表格,请参阅 扩展 Google 表格

Google 表格结构

一个 Google 表格电子表格包含一个或多个工作表。每个工作表本质上都是一个二维单元格网格,您可以在其中存储文本、数字、链接或其他值。一个或多个相邻单元格的组合称为“范围”

Apps 脚本 电子表格服务提供了多个 类来表示 Google 表格中的组织结构(例如 SheetRange)。您可以使用这些 类来读取和修改 Google 表格数据和行为。

触发器

借助 Apps 脚本 触发器,脚本 项目可以在满足某些条件(例如 打开电子表格或安装插件)时执行指定的函数。

如需详细了解哪些触发器可用于 Google 表格插件以及使用这些触发器时有哪些限制,请参阅插件触发器

自定义函数

Google 表格具有许多 内置函数 ,例如 SUMAVERAGE,这些函数可以从 Google 表格单元格内调用。Google 表格插件可以 定义其他 自定义函数 来 补充这些内置函数。当用户安装插件时,插件中包含的任何已定义的自定义函数都会立即可用。插件可以仅包含自定义函数定义。自定义函数定义主要通过发布包含这些定义的插件与他人共享。

创建插件自定义函数

在插件脚本项目中定义的任何函数都可以用作自定义函数。实现该函数并安装插件后,您可以像调用任何其他内置 Google 表格函数一样调用自定义函数:在 Google 表格单元格中,输入=,后跟函数名称和任何必需的参数。如果没有出现错误,函数返回的结果将放置在 Google 表格单元格中,并根据需要溢出到相邻单元格。

在插件中创建自定义函数时,您应遵循以下一般自定义函数指南:

此外,在插件中定义的自定义函数还有一些特殊注意事项:

  • 为函数命名时,请尝试创建一个唯一的名称,该名称可能与插件的名称相关。如果两个或多个已安装的插件定义了名称相同的自定义函数,用户只能使用其中一个。
  • 您的插件应明确说明它提供的自定义函数。请务必为您的 自定义函数提供准确的 JSDoc 注释,以便 Apps 脚本可以向用户显示 自动补全信息 。此外,请考虑在插件本身中或在插件支持网页上提供自定义函数的其他文档。
  • 未在 30 秒内完成的自定义函数会失败,并显示 Internal error executing the custom function 错误。通过限制在自定义函数中执行的处理量,打造良好的用户体验。 尽可能优化函数 。
  • 自定义函数无法使用需要授权的 Apps 脚本服务,如果尝试使用,则会失败并显示 You do not have permission to call X service 错误。请仅在自定义函数中使用 允许的 服务
  • Google 表格中的每个自定义函数都会导致对 Apps 脚本服务器进行单独调用。如果用户尝试在过多单元格中使用自定义函数,这些函数可能会执行缓慢。为缓解此问题,请尽可能使自定义函数简单明了。如果您需要函数执行复杂或扩展的处理,请不要使用自定义函数,而是使用菜单项、对话框或侧边栏互动来提供该功能。

Google 表格宏

借助宏,您可以记录在 Google 表格中执行的操作 ,并稍后使用键盘快捷键重复这些操作。 在 Google 表格中创建宏时,该宏会作为宏 函数添加到与该 Google 表格绑定的 Apps 脚本项目中。如需详细了解宏,请参阅 Google 表格宏

遗憾的是,Google 表格宏无法通过 插件分发。如果您在插件的清单中添加宏定义,该插件的用户将无法使用该宏。