如何让Google Apps Script标准Calendar Service使用域范围委派？

要让内置Calendar Service使用域范围委派访问指定用户的日历，核心是通过用户身份模拟实现，无需手动管理OAuth2令牌。以下是具体方案：

必要前提 #

• 脚本需由Google Workspace域管理员创建或授权
• 已在Google Admin控制台中，为该脚本的OAuth客户端ID配置Calendar相关的域范围权限（如https://www.googleapis.com/auth/calendar）
• 脚本需启用https://www.googleapis.com/auth/script.external_request权限（在脚本编辑器的「项目设置」中勾选「显示"appsscript.json"清单文件」，然后在清单中添加该权限）

替换后的脚本实现 #

无需依赖OAuth2库，直接通过身份切换使用内置服务：

function run() {
  const targetUser = '[Redacted]@daimto.com'; // 目标用户邮箱

  try {
    // 切换到目标用户身份，后续内置服务调用均以此身份执行
    Session.setEffectiveUser(targetUser);

    // 使用内置Calendar Service操作目标用户的日历
    const primaryCalendar = CalendarApp.getDefaultCalendar();
    Logger.log(`成功访问用户日历：${primaryCalendar.getName()}`);

    // 示例：获取未来7天的日历事件
    const nextWeek = new Date(Date.now() + 7 * 24 * 60 * 60 * 1000);
    const events = primaryCalendar.getEvents(new Date(), nextWeek);
    Logger.log(`未来7天共有${events.length}个事件`);
  } catch (error) {
    Logger.log(`操作失败：${error.message}`);
  }
}

关键原理 #

Session.setEffectiveUser()方法会让Google Apps Script的内置服务（包括CalendarApp）以指定用户的身份发起请求，这一能力依赖于域管理员预先配置的域范围委派权限，无需手动处理令牌生成与验证。

Gmail签名更新脚本示例 #

同理，强制更新用户Gmail签名可使用相同逻辑结合Gmail内置服务：

function updateGmailSignature() {
  const targetUser = '[Redacted]@daimto.com';
  const newSignature = `
    <p>这是更新后的签名内容</p>
    <p>联系邮箱：${targetUser}</p>
  `;

  try {
    Session.setEffectiveUser(targetUser);
    GmailApp.setSignature(newSignature);
    Logger.log(`已成功更新${targetUser}的Gmail签名`);
  } catch (error) {
    Logger.log(`更新失败：${error.message}`);
  }
}

内容的提问来源于stack exchange，提问作者Linda Lawton - DaImTo