在Apps Script库中使用Gmail受限范围，是否无需客户端配置相同范围？

DevOps 小满

2026-7-24

问题描述

我开发了一款带附加功能的邮件合并Google Apps Script（GAS）库，目标是让客户只需将库及少量样板代码添加到Google表格即可直接使用。此前运行一切正常，但添加自动在邮件末尾附加用户签名的功能后出现问题。

获取签名的库代码如下：

const signature = Gmail.Users.Settings.SendAs.list("me").sendAs.filter(function(account){if(account.isDefault){return true}})[0].signature;

这段代码调用了Gmail的受限范围，我已将GCP项目从默认升级为标准项目（应用尚未验证），库本身可正常生成签名。但在客户端表格测试时，出现错误：

Exception: Service Gmail API has not been enabled for your Apps Script-managed Cloud Platform project. If you recently turned on this advanced Google service, wait a few minutes for the action to propagate to our systems and retry.

注释签名代码后，客户端恢复正常运行。现咨询：能否在Apps Script库中使用受限范围，而无需客户端拥有相同范围？（我并非GAS新手，但此前未接触过GCP，可能存在理解偏差）

回答

核心结论：不行，客户端必须满足库依赖的所有权限和API启用要求
当库中调用Gmail API这类高级服务时，客户端的表格绑定脚本（用户的Apps Script项目）必须同时满足两个条件：
1. 启用对应的高级Google服务（此处为Gmail API）
2. 拥有库所需的OAuth权限范围（获取签名需要https://www.googleapis.com/auth/gmail.settings.basic权限）
报错原因
你的库所在的GCP项目已启用Gmail API，但客户端脚本默认关联的是自身的GCP默认项目，该项目未启用Gmail API，因此运行时触发权限与服务缺失的错误。
可行解决方案
1. 引导客户端手动启用Gmail API
  告知用户在其表格绑定脚本中，通过「编辑器 > 资源 > 高级Google服务」找到Gmail API并启用，同时确保对应GCP项目（默认或标准项目均可）中也启用了该API。
2. 让客户端关联你的标准GCP项目
  若不想让用户自行操作，可提供你的标准GCP项目编号，引导用户在其脚本项目的「编辑器 > 项目设置 > 关联Cloud Platform项目」中输入该编号。这样客户端脚本会复用你已配置好的GCP项目（已启用Gmail API、配置好权限范围），但用户仍需亲自授权同意库请求的权限（OAuth权限为用户级，必须由用户本人确认）。
3. 封装签名逻辑并明确告知配置要求
  虽无法绕过权限要求，但可将签名获取逻辑封装为库内独立函数，同时在库文档中明确告知用户需要启用Gmail API及对应权限，减少用户配置困惑。
关于未验证应用的提示
由于你的应用尚未通过Google验证，用户授权时会看到「未验证应用」警告，可引导用户通过「高级 > 继续访问」完成授权，或尽快完成应用验证流程以提升体验。

内容的提问来源于stack exchange，提问作者T Hallman