Google Sheets脚本调用Calendar App时权限异常求助

核心原因 #

Google Sheets中通过单元格公式调用的自定义函数运行在受限沙箱环境中，不允许调用需要OAuth授权的服务（比如CalendarApp）——哪怕你在appsscript.json里配置了权限范围也没用。这是Google的安全限制，防止未授权的公式随意访问用户隐私数据。

而你在调试器里能正常运行，是因为调试器/手动运行函数时，是在完整权限环境下执行的，会使用你配置的oauthScopes权限。

可行解决方案 #

不能用单元格公式直接调用这类需要授权的函数，换以下方式实现需求：

1. 自定义菜单触发（推荐）

创建一个自定义菜单，让用户点击菜单来运行函数，把结果写入表格：

// 表格打开时创建自定义菜单
function onOpen() {
  SpreadsheetApp.getUi()
    .createMenu('日历工具')
    .addItem('获取我的日历列表', 'writeCalendarsToSheet')
    .addToUi();
}

// 获取日历并写入表格
function writeCalendarsToSheet() {
  const calendarNames = CalendarApp.getAllOwnedCalendars().map(cal => cal.getName());
  const activeSheet = SpreadsheetApp.getActiveSheet();
  
  // 清空A列旧数据（可选）
  activeSheet.getRange('A:A').clearContent();
  // 把日历名称写入A列，从A1开始
  activeSheet.getRange(1, 1, calendarNames.length, 1).setValues(calendarNames.map(name => [name]));
}

部署后，打开表格会看到顶部的「日历工具」菜单，点击选项就能获取并写入日历列表，首次运行会要求授权，授权后即可正常使用。

2. 安装式触发器

如果需要自动执行（比如打开表格时自动加载），可以设置安装式触发器：

• 打开脚本编辑器，点击左侧「触发器」图标
• 添加触发器，选择writeCalendarsToSheet函数，触发事件选「打开时」
• 保存并完成授权，之后每次打开表格都会自动获取日历列表

补充说明 #

你在appsscript.json里配置的oauthScopes是正确的，但仅适用于菜单、触发器、手动运行/调试的场景，单元格自定义函数完全不支持这类权限请求，这是平台的硬性限制，没有绕过方法。

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