Google Apps Script中DriveApp与GmailApp无法同时使用问题求助

问题概述 #

• 单独调用DriveApp可正常访问目标文件夹
• 单独调用GmailApp可正常检索星标邮件
• 同一脚本内同时调用两者时，抛出权限错误：Exception: Authorization is required to perform that action test @code.gs.2

代码示例 #

// 注意：FolderID、sheetID需替换为实际的ID值
function test () {
    let folder = DriveApp.getFolderById(FolderID);
    let threads = GmailApp.search('is:starred')
    let sheet = SpreadsheetApp.openById(sheetID)

    console.log({
        folder : folder,
        threads : threads,
        sheet : sheet
    })
}

已尝试的排查步骤 #

• 检查appsscript.json的权限范围，确认包含Drive和Gmail相关API权限
• 完成两个服务的完整授权流程
• 将服务调用拆分至不同函数，组合执行时问题仍存在
• 创建新项目重写代码，问题复现
• 清除浏览器缓存、更换浏览器登录尝试，未解决

原因分析 #

1. Apps Script的自动权限生成机制可能未正确合并多服务的权限范围，导致执行时权限上下文不完整
2. 首次授权时未同时触发多权限的审批流程，后续执行时缺失部分权限
3. 权限范围存在隐性冲突，比如宽泛权限与限定权限的组合导致授权会话异常

解决方法 #

1. 手动指定明确的权限范围 #

打开脚本编辑器的appsscript.json文件（若未显示，可通过「查看」→「显示清单文件」开启），添加对应服务的最小必要权限：

{
  "oauthScopes": [
    "https://www.googleapis.com/auth/drive.readonly", // 若需读写则改为https://www.googleapis.com/auth/drive
    "https://www.googleapis.com/auth/gmail.readonly", // 若需读写则改为https://www.googleapis.com/auth/gmail.modify
    "https://www.googleapis.com/auth/spreadsheets.readonly" // 若需读写则改为https://www.googleapis.com/auth/spreadsheets
  ]
}

保存后，重新触发授权流程。

2. 重置并重新完成完整授权 #

• 进入Google账号「安全」页面，找到「第三方应用权限」，移除当前Apps Script项目的权限
• 回到脚本编辑器，先单独执行仅调用DriveApp的函数（比如新建一个testDrive()函数），完成Drive服务的授权
• 再单独执行仅调用GmailApp的函数（比如新建testGmail()函数），完成Gmail服务的授权
• 最后执行包含所有服务调用的test()函数，确认权限加载正常

3. 拆分服务调用并分批授权 #

将不同服务的逻辑拆分为独立函数，先分别完成每个函数的授权，再执行主函数：

function getDriveFolder() {
  return DriveApp.getFolderById(FolderID);
}

function getGmailThreads() {
  return GmailApp.search('is:starred');
}

function getSpreadsheet() {
  return SpreadsheetApp.openById(sheetID);
}

function test() {
  let folder = getDriveFolder();
  let threads = getGmailThreads();
  let sheet = getSpreadsheet();

  console.log({ folder, threads, sheet });
}

依次执行getDriveFolder()、getGmailThreads()、getSpreadsheet()完成各自授权后，再运行test()。

4. 避免过度授权 #

尽量使用最小必要权限，比如仅需读取Drive文件夹时使用drive.readonly而非全权限drive，减少权限冲突的概率。

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