Google 服务授权

Apps 脚本需要用户授权才能访问内置 Google 服务高级 Google 服务中的私密数据。

授予访问权限

Apps 脚本会根据扫描代码自动确定授权范围(例如访问您的 Google 表格文件或 Gmail)。被注释掉的代码仍然可以生成授权请求。如果某个脚本需要授权,则在脚本运行时,您会看到此处显示的其中一个授权对话框。

如果代码更改添加了新服务,您之前授权的脚本也会请求额外授权。如果您以 Web 应用的形式(以脚本所有者的用户身份运行的)访问脚本,则脚本可能不会请求授权。

撤消访问权限

要撤消脚本对您数据的访问权限,请按以下步骤操作:

  1. 访问您 Google 帐号的权限页面。(今后如需导航到此页面,请访问 Google.com,然后点击屏幕右上角的帐号图片。接下来,依次点击我的账号、“登录和安全”部分下的关联的应用和网站,然后点击管理应用。)
  2. 点击您要撤消授权的脚本的名称,然后点击右侧的移除,然后在出现的对话框中点击确定

脚本的权限和类型

运行脚本的用户身份(以及脚本可以访问的数据)因运行脚本的场景而异,如下表所示。

脚本类型 脚本的运行身份...
独立式插件 绑定到文档、表格、幻灯片或表单 正在使用键盘的用户
电子表格中的自定义函数 匿名用户;不过,配额限制会计入使用键盘的用户
Web 应用Google 协作平台小工具 键盘或脚本所有者的用户,具体取决于部署应用时所选的选项
可安装的触发器 创建触发器的用户

表格、文档、幻灯片和表单的手动授权范围

如果您要构建使用电子表格服务文档服务幻灯片服务表单服务插件或其他脚本,则可以强制授权对话框仅请求访问使用该插件或脚本的文件,而不是用户的所有电子表格、文档或表单。为此,请在文件级注释中添加以下 JsDoc 注释:

/**
 * @OnlyCurrentDoc
 */

如果您的脚本包含一个声明 @OnlyCurrentDoc,但主脚本实际上需要访问的文件不止当前文件,则可以使用相反的注解 @NotOnlyCurrentDoc

插件的授权生命周期

Google 表格、文档、幻灯片和表单的插件通常遵循与绑定到文档的脚本相同的授权模型。但在某些情况下,它们的 onOpen(e)onEdit(e) 函数会在无授权模式下运行,这会导致一些额外的复杂问题。如需了解详情,请参阅插件授权生命周期指南

OAuth 应用用户限制

使用 OAuth 访问 Google 用户数据的应用(包括 Apps 脚本项目)需遵循授权限制。如需了解详情,请参阅 OAuth 应用用户限制