Google Calendar脚本调用getEvents方法报错：TypeError问题排查与修复

错误原因分析 #

你遇到的TypeError: Cannot call method "getEvents" of null其实很典型——本质是CalendarApp.getCalendarById('aaa@bbb.com')返回了null，相当于你试图调用一个不存在的对象的方法，自然会报错。通常有这几种诱因：

• 填写的日历ID完全不正确
• 当前Google账号没有访问该日历的权限（比如是他人共享的日历，但对方没给你查看权限）
• 脚本没有获得足够的日历访问授权

修复步骤 #

1. 确认日历ID的准确性

先拿到真正正确的日历ID：

• 打开Google日历网页版，找到目标日历
• 点击日历名称旁的三个点 → 设置和共享
• 滚动到「集成日历」板块，复制完整的「日历ID」（格式通常是xxxxxx@group.calendar.google.com，不一定是普通邮箱地址）
• 把代码里的aaa@bbb.com替换成这个正确的ID

2. 检查日历访问权限

如果是共享日历：

• 让日历所有者确认已经把你的Google账号添加为查看者（或更高权限）
• 自己也可以在Google日历左侧列表里确认该日历是否已显示（如果没显示，需要先手动添加共享日历）

3. 重新授权脚本权限

有时候脚本的授权会出现异常，导致无法访问日历：

• 在Script Editor中，点击顶部「运行」按钮旁边的权限图标（钥匙形状）
• 选择「重新授权」，按照提示完成权限授予，确保允许脚本访问你的日历数据

4. 增加空值检查（推荐优化）

为了让脚本更健壮，避免直接崩溃，你可以在调用getEvents前先判断日历对象是否存在：

function getEvents() { 
  // 替换成你正确的日历ID
  var targetCalId = 'your-calendar-id-here@group.calendar.google.com';
  var cal = CalendarApp.getCalendarById(targetCalId); 

  // 先检查日历是否存在
  if (!cal) {
    Logger.log('错误：无法找到指定ID的日历，请检查ID或权限');
    return;
  }

  var events = cal.getEvents(new Date("01/01/2018 12:00 AM"), new Date("12/31/2018 11:59 PM")); 
  // 用let声明i，避免全局变量污染
  for(let i=0; i<events.length;i++){ 
    var title = events[i].getTitle();
    Logger.log(title);
  } 
}

验证方法 #

修改完成后重新运行脚本，打开查看 > 日志：如果能看到日历事件的标题，说明问题解决；如果日志显示自定义的错误提示，就回头再检查日历ID和权限设置。

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