容器绑定脚本调用Calendar API的OAuth认证问题及配置方法

我需要开发一个Apps Script项目，通过编程方式向Google Calendar添加eventType为"workingLocation"的事件，因此必须使用Calendar API（无法用CalendarApp替代）。

基础代码如下：

const calendarId = 'primary';

const requiredArgs = {
  start: { date: '2023-08-01' },
  end: { date: '2023-08-02' },
  eventType: "workingLocation",
  visibility: "public",
  transparency: "transparent",
  workingLocationProperties: {
    type: 'officeLocation'
  }
}
try {
  var event = Calendar.Events.insert(requiredArgs, calendarId);
  console.log("Location created");
} catch (exception) {
  console.log(exception.message);
}

这段代码在独立Apps Script项目中可正常运行，但在Sheets容器绑定脚本（计划通过表格定义工作地点批量更新日历）中调用Calendar.Events.insert时，出现如下错误：

Request is missing required authentication credential. Expected OAuth 2 access token, login cookie or other valid authentication credential.

疑问： #

为什么容器绑定脚本中使用Calendar API需要额外认证，而独立脚本无需配置？该如何为容器绑定脚本配置OAuth访问权限？

原因说明 #

独立脚本与容器绑定脚本的OAuth权限默认逻辑不同：

• 独立脚本首次运行时，会自动检测所需API权限并引导用户完成授权；
• 容器绑定脚本（如绑定到Sheet的脚本）默认的OAuth范围仅包含与宿主应用（Sheet）相关的权限，不会自动包含Calendar API的访问权限，因此调用Calendar API时会出现认证缺失的错误。

配置步骤 #

1. 手动添加OAuth权限范围

   • 打开绑定脚本的编辑器，点击右上角齿轮图标（设置），勾选显示"appsscript.json"清单文件；
   • 打开appsscript.json文件，在oauthScopes数组中添加Calendar API的权限：

     "oauthScopes": [
       "https://www.googleapis.com/auth/spreadsheets",
       "https://www.googleapis.com/auth/calendar"
     ]
     

     注：若想限制权限，可使用https://www.googleapis.com/auth/calendar.events（仅事件读写），但创建workingLocation事件需要足够权限，建议先使用全权限测试。

2. 重新完成OAuth授权

   • 保存appsscript.json后，回到脚本编辑器，运行任意函数（比如你的插入事件函数）；
   • 按照弹出的授权窗口提示，完成账号授权操作，确保使用的是拥有目标Calendar权限的账号。

3. 检查触发器权限（若使用触发器）

   • 如果脚本通过时间驱动触发器或Sheet onChange触发器运行，需确保触发器由拥有Calendar权限的账号创建；
   • 若旧触发器是在权限不全时创建的，建议删除后重新创建，并在创建过程中完成完整授权。

4. 验证权限生效

   • 重新运行脚本，若不再出现认证错误则配置成功；若仍有问题，可检查Google账号的第三方应用权限设置，确认该Apps Script项目的权限已被允许。

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