如果脚本已绑定到 Google 表格、文档、幻灯片或表单文件, 创建自该文档,而不是作为独立脚本创建。 绑定脚本附加到的文件称为“容器”。 绑定脚本的行为通常与独立脚本类似,只不过它们 不会显示在 Google 云端硬盘中,因此无法将其从文件中分离 并会获得对父文件的一些特殊权限。
请注意,脚本也可以绑定到 Google 协作平台,但这些脚本 几乎总是部署为 Web 应用。脚本 绑定至 Google 表格、文档、幻灯片或表单的软件包也可成为 Web 应用, 这种情况并不常见。
创建绑定脚本
Google 文档、表格或幻灯片
要在 Google 文档、表格或幻灯片中创建绑定脚本,请在以下位置打开文档: 文档、Google 表格中的电子表格或 Google 幻灯片中的演示文稿,然后点击 扩展程序 > Apps 脚本。要在以下位置重新打开脚本 执行相同的操作或从 Apps 脚本信息中心。
Google 表单
要在 Google 表单中创建绑定脚本,请打开相应表单 然后点击“更多”图标 > 脚本 编辑器。要在 执行相同的操作,也可以从 Apps 脚本信息中心。
特殊方法
绑定脚本可以调用独立脚本无法调用的一些方法:
getActiveSpreadsheet()
、getActiveDocument()
、getActivePresentation()
, 和getActiveForm()
允许绑定脚本引用其父文件,而不引用 文件 ID。getUi
允许 绑定脚本访问其父文件的界面,以便将 自定义菜单、对话框和边栏。- 在 Google 表格中,
getActiveSheet()
、getActiveRange()
、 和getActiveCell()
让脚本确定用户的当前工作表、选定的单元格范围,或者 已选定单个单元格setActiveSheet(sheet)
和setActiveRange(range)
让脚本更改这些选择 - 在 Google 文档中,
getActiveTab()
、getCursor()
和getSelection()
让脚本确定用户的当前标签页、用户 光标或所选文字。setActiveTab(tabId)
、setCursor(position)
和setSelection(range)
让脚本更改这些选择
有关详情,请参阅 Google 表格扩展指南或 扩展 Google 文档的指南。
自定义菜单、对话框和边栏
绑定脚本可以自定义 Google 表格、文档和表单,方法是将 自定义菜单和 对话框或边栏。请注意: 但脚本只能与 打开文件的当前实例。即,将一个脚本绑定到一个文档 不会影响其他文档的用户界面
插件
插件在 Gmail、Google 表格、文档、 幻灯片和表单。如果您确定了边界或 独立广告 并希望与全世界的用户分享,而使用 Apps 脚本, 将脚本发布为 以便其他用户通过插件商店进行安装。
触发器
绑定脚本可以使用简单触发器
就像特殊的 onOpen()
函数一样,该函数会在每次文件上传时自动运行
已由拥有编辑权限的用户打开。与所有类型的脚本一样,
还使用可安装的触发器。
自定义函数
自定义函数是
脚本绑定到 Google 表格,您可以使用
语法 =myFunctionName()
。因此,自定义函数类似于
Google 表格中的内置函数
例如 AVERAGE
或
SUM
自定义函数的行为。
拥有对绑定脚本的访问权限
只有有权修改容器的用户才能运行该容器的绑定脚本。 仅拥有查看权限的协作者无法打开脚本 但如果他们制作了容器文件的副本, 并且可以查看和运行脚本的副本。
要了解如何共享脚本的容器文件,请参阅从 Google 云端硬盘。