使用插件扩展 Google 表格

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

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

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

可以采取的措施

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

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

工作表结构

Google 表格由一张或多张工作表组成。每个工作表本质上是一个单元格的 2D 网格,文本、数字、链接或其他值可存储到这些单元格中。由一个或多个相邻单元格组成的组称为范围

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

触发器

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

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

自定义函数

Google 表格有许多内置函数(如 SUMAVERAGE),可在 Google 表格单元格中调用。Google 表格插件可以定义其他自定义函数,以对这些内置函数进行补充。在用户安装该插件后,该插件包含的任何已定义的自定义函数都会立即可用。插件可以只包含自定义函数定义。自定义函数定义主要通过发布包含这些定义的插件与其他人共享。

创建插件自定义函数

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

在插件中创建自定义函数时,应遵循自定义函数常规准则:

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

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

表格宏

可让您记录在 Google 表格中执行的操作,并且稍后可通过键盘快捷键重复执行。在工作表中创建宏后,系统会将宏作为宏函数添加到绑定到该工作表的 Apps 脚本项目中。如需详细了解宏,请参阅 Google 表格宏

很遗憾,Google 表格宏无法随插件一起分发。如果您在某个插件的清单中添加了宏定义,该插件的用户将无法使用此定义。