Google Apps Script操作Google Calendar时Event返回null问题求助

我之前也踩过一模一样的坑！大概率是这几个原因导致的，咱们一步步排查：

1. 先确认事件列表是否真的有数据 #

你的代码直接取events[0]，但如果getEvents(start, end)返回的是空数组，event_id会变成undefined，调用getEventById自然返回null。先加个判断兜底：

var events = calendar.getEvents(start, end);
if (events.length === 0) {
  Logger.log("当前时间范围内没有事件！");
  return;
}
var event_id = events[0].getId();

2. 检查事件ID的格式是否正确 #

CalendarApp.Event.getId()返回的是完整的事件ID（格式类似abc123xyz@google.com），你必须把这个完整字符串原封不动传给getEventById，别手动截取或修改。建议先打印ID看看具体内容：

Logger.log("获取到的事件ID：" + event_id);

如果日志里的ID是空值或者格式奇怪，那问题出在获取事件列表的步骤。

3. 重复事件的特殊处理 #

如果events[0]是重复系列事件，getEventById可能无法直接获取，这时候得用getEventSeriesById()来获取整个系列：

var eventSeries = calendar.getEventSeriesById(event_id);
Logger.log("重复事件系列标题：" + eventSeries.getTitle());

4. 日历权限验证 #

虽然你能调用getEvents，但共享日历的权限可能有隐藏限制（比如只能看忙/闲状态，看不到完整事件详情）。检查一下你使用的账号是否有该日历的查看所有事件权限，而不是仅忙/闲权限。

修正后的完整代码示例 #

var cal_id = "xxxxxxxxxxx@group.calendar.google.com"; 
var start = new Date(); 
var end = new Date(new Date().setFullYear(new Date().getFullYear() + 3)); 
var calendar = CalendarApp.getCalendarById(cal_id);

// 先验证日历是否成功获取
if (!calendar) {
  Logger.log("无法找到指定日历，请检查cal_id是否正确！");
  return;
}

var events = calendar.getEvents(start, end);
if (events.length === 0) {
  Logger.log("当前时间范围内没有事件！");
  return;
}

var event_id = events[0].getId();
Logger.log("事件ID：" + event_id);

var event = calendar.getEventById(event_id);
if (event) {
  Logger.log("获取到的事件标题：" + event.getTitle());
} else {
  // 尝试获取重复事件系列
  var eventSeries = calendar.getEventSeriesById(event_id);
  if (eventSeries) {
    Logger.log("获取到重复事件系列标题：" + eventSeries.getTitle());
  } else {
    Logger.log("无法找到对应事件或事件系列！");
  }
}

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