Google 表格是一种云端电子表格解决方案,提供实时协作和强大的工具,可用于直观呈现、处理和传递数据。
您可以使用插件来扩展 Google 表格,从而改进自定义工作流程、与第三方系统建立连接,并将您的表格数据与其他 Google Workspace 应用(例如 Google 幻灯片)集成。
您可以查看其他人在 Google Workspace Marketplace 中构建的表格插件。
可以采取的措施
您可以使用扩展 Google 表格的插件执行以下操作:
- 您可以使用内置的 Apps 脚本电子表格服务来读取、修改和直观呈现 Google 表格电子表格中的数据,以及设置其格式。借助该服务,您还可以创建和修改条件格式设置和数据验证规则。
- 您可以使用 Apps 脚本高级表格服务直接访问 Google Sheets API。
- 您可以使用标准 HTML 和 CSS 创建自定义菜单并定义多个自定义对话框和边栏界面。
- 您可以在插件中添加自定义函数定义。
- 您可以使用插件触发器,使其在发生某些触发事件时运行指定函数。
Google 表格插件是使用 Apps 脚本构建的。要详细了解如何使用 Apps 脚本访问和管理 Google 表格,请参阅扩展 Google 表格。
工作表结构
Google 表格由一张或多张工作表组成。每个工作表本质上是一个单元格的 2D 网格,文本、数字、链接或其他值可存储到这些单元格中。由一个或多个相邻单元格组成的组称为范围。
Apps 脚本电子表格服务提供了一些类来表示 Google 表格中的组织结构(例如 Sheet
和 Range
)。您可以使用这些类读取和修改 Google 表格的数据和行为。
触发器
借助 Apps 脚本触发器,脚本项目可以在满足特定条件时执行指定的函数,例如当打开电子表格或安装插件时。
请参阅插件触发器,详细了解哪些触发器可用于 Google 表格插件以及在使用时有什么限制。
自定义函数
Google 表格有许多内置函数(如 SUM
和 AVERAGE
),可在 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 表格宏无法随插件一起分发。如果您在某个插件的清单中添加了宏定义,该插件的用户将无法使用此定义。