容器绑定脚本

如果脚本已绑定到 Google 表格、文档、幻灯片或表单文件， 创建自该文档，而不是作为独立脚本创建。 绑定脚本附加到的文件称为“容器”。 绑定脚本的行为通常与独立脚本类似，只不过它们 不会显示在 Google 云端硬盘中，因此无法将其从文件中分离 并会获得对父文件的一些特殊权限。

请注意，脚本也可以绑定到 Google 协作平台，但这些脚本 几乎总是部署为 Web 应用。脚本 绑定至 Google 表格、文档、幻灯片或表单的软件包也可成为 Web 应用， 这种情况并不常见。

注意 ：绑定脚本实际上会被取消发布 仅对以下服务起作用的插件： 所绑定的文件。

创建绑定脚本

Google 文档、表格或幻灯片

要在 Google 文档、表格或幻灯片中创建绑定脚本，请在以下位置打开文档： 文档、Google 表格中的电子表格或 Google 幻灯片中的演示文稿，然后点击 扩展程序 > Apps 脚本。要在以下位置重新打开脚本 执行相同的操作或从 Apps 脚本信息中心。

Google 表单

要在 Google 表单中创建绑定脚本，请打开相应表单 然后点击“更多”图标 > 脚本 编辑器。要在 执行相同的操作，也可以从 Apps 脚本信息中心。

注意： clasp 工具无法创建绑定脚本， 但可以克隆和修改它们。

特殊方法

绑定脚本可以调用独立脚本无法调用的一些方法：

• getActiveSpreadsheet(), getActiveDocument(), getActivePresentation(), 和getActiveForm() 允许绑定脚本引用其父文件，而不引用 文件 ID。
• getUi 允许 绑定脚本访问其父文件的界面，以便将 自定义菜单、对话框和边栏。
• 在 Google 表格中，getActiveSheet()、 getActiveRange(), 和getActiveCell() 让脚本确定用户的当前工作表、选定的单元格范围，或者 已选定单个单元格 setActiveSheet(sheet) 和setActiveRange(range) 让脚本更改这些选择
• 在 Google 文档中，getCursor() 和getSelection() 让脚本确定用户的光标或所选文字的位置。 setCursor(position) 和setSelection(range) 让脚本更改这些位置。

有关详情，请参阅 Google 表格扩展指南或 扩展 Google 文档的指南。

注意 ：这些方法仅适用于从 脚本编辑器、菜单项、对话框、边栏或触发器。当边界 作为 Web 应用运行，或通过 Apps Script API，则这些方法不会 可用。

自定义菜单、对话框和边栏

绑定脚本可以自定义 Google 表格、文档和表单，方法是将 自定义菜单和 对话框或边栏。请注意： 但脚本只能与 打开文件的当前实例。即，将一个脚本绑定到一个文档 不会影响其他文档的用户界面

插件还可以添加自定义菜单、对话框和边栏。 建议您使用 独立脚本。

插件

插件在 Gmail、Google 表格、文档、 幻灯片和表单。如果您确定了边界或 独立广告 并希望与全世界的用户分享，而使用 Apps 脚本， 将脚本发布为 以便其他用户通过插件商店进行安装。

触发器

绑定脚本可以使用简单触发器 就像特殊的 onOpen() 函数一样，该函数会在每次文件上传时自动运行 已由拥有编辑权限的用户打开。与所有类型的脚本一样， 还使用可安装的触发器。

自定义函数

自定义函数是 脚本绑定到 Google 表格，您可以使用 语法 =myFunctionName()。因此，自定义函数类似于 Google 表格中的内置函数 例如 AVERAGE 或 SUM 自定义函数的行为。

拥有对绑定脚本的访问权限

只有有权修改容器的用户才能运行该容器的绑定脚本。 仅拥有查看权限的协作者无法打开脚本 但如果他们制作了容器文件的副本， 并且可以查看和运行脚本的副本。

要了解如何共享脚本的容器文件，请参阅从 Google 云端硬盘。

所有容器绑定脚本均使用相同的所有者、查看者和 为容器文件定义的编辑者访问权限列表。容器所有者接受 并始终拥有新脚本项目的所有权。