库是一种脚本项目，其函数可在其他脚本中重复使用。
获取对某个库的访问权限
如需在项目中添加库，您必须至少拥有对该库的查看级访问权限。如果您不是要包含的库的作者，请与作者联系并申请访问权限。
您需要包含的库的脚本 ID。如果您有权访问该库，则可以在项目设置 页面上找到脚本 ID。
向脚本项目添加库
- 在 Apps 脚本编辑器的左侧，点击“库”旁边的“添加库”图标 。
- 在“脚本 ID”字段中，粘贴库的脚本 ID。
- 点击查找。
- 点击版本下拉菜单，然后选择要使用的库版本。
- 检查默认的“标识符”名称是否是您想在此库中使用的名称。这是脚本用于引用库的名称。例如，如果您将其设置为
Test，则可以按如下方式调用该库的方法：Test.libraryMethod()。 - 点击添加。
使用库
像使用默认服务一样使用您包含的库。例如，如果 Test 是库的标识符，请键入 Test，然后紧跟一个英文句点，即可查看库中的方法列表。
您可以按照以下步骤打开所含库的参考文档：
在脚本编辑器的左侧，点击库名称旁边的“更多”图标 >“在新标签页中打开”。
移除媒体库
在脚本编辑器的左侧，点击库名称旁边的“更多”图标 >“移除”>“移除库”。
更新库
您可以更改库的版本或更新其标识符。
- 在编辑器左侧的“库”下方，点击相应库的名称。
- 完成更改后，点击保存。
创建和共享库
如需使用和分享您的脚本项目作为库，请按以下步骤操作。
- 为脚本创建版本化部署。
- 与库的所有潜在用户共享至少查看级访问权限。
- 将脚本 ID 提供给这些用户，该 ID 可在项目设置 页面上找到。
最佳做法
以下是编写库时需要遵循的一些准则：
- 为项目选择一个有意义的名称，因为当其他人包含您的库时，该名称会用作默认标识符。
- 如果您希望脚本中的一个或多个方法对库用户不可见（也不可使用），可以在方法名称末尾添加下划线。例如
myPrivateMethod_()。 - 只有可枚举的全局属性对库用户可见。这包括函数声明、使用
var在函数外部创建的变量，以及在全局对象上显式设置的属性。例如，将enumerable设置为false的Object.defineProperty()会创建一个可在库中使用的符号，但用户无法访问此符号。 如果您希望库用户能够使用脚本编辑器自动补全功能和自动生成的文档，则必须为所有函数提供 JSDoc 样式的文档。示例如下：
/** * Raises a number to the given power, and returns the result. * * @param {number} base the number we're raising to a power * @param {number} exp the exponent we're raising the base to * @return {number} the result of the exponential calculation */ function power(base, exp) { ... }
资源范围界定
使用库时，资源分为两种类型：共享资源和非共享资源。共享资源是指库和包含脚本都内置了对同一资源实例的访问权限。下图以用户属性为例，展示了共享资源：
非共享资源是指库和包含脚本都只能内置访问其资源实例。不过，库可以通过提供对非共享资源进行操作的显式函数来提供对这些资源的访问权限。以下是一个函数的示例，您可以将其纳入库中以公开其脚本属性：
function getLibraryProperty(key) {
const scriptProperties = PropertiesService.getScriptProperties();
return scriptProperties.getProperty(key);
}
下图以脚本属性为例，展示了非共享资源：
下表列出了共享资源和非共享资源，供您参考：
| 资源 | 已分享* | 未共享** | 备注 |
|---|---|---|---|
| 锁定 |  |
在库中创建的同一实例对所有人（包括脚本）可见。 | |
| 脚本属性 | |
在库中创建的同一实例对所有人（包括脚本）可见。 | |
| 缓存 | |
在库中创建的同一实例对所有人（包括脚本）可见。 | |
| 触发器 | |
在库中创建的简单触发器不会由包含脚本触发。 | |
| ScriptApp | |
||
| UiApp |
|
||
| 用户属性 | |
||
| 记录器和执行记录 | |
||
| 网站、工作表和其他容器 | |
对 getActive() 的调用会返回包含脚本的容器。 |
|
| MailApp 和 GmailApp | |
||
|
* 这意味着库没有自己的功能/资源实例，而是使用调用它的脚本创建的实例。
** 这意味着库拥有资源/功能的自有实例，并且使用该库的所有脚本共享并有权访问该同一实例。 | |||
测试库
如需测试您的库，请使用 Head 部署。任何对脚本具有编辑者级访问权限的用户都可以使用 Head 部署。
调试库
在包含库的项目中使用调试器时，您可以步入所含库的函数。代码以只读模式显示在调试器中，并且版本正确。