Apps Script中CalendarApp.getEventById无法获取部分日历事件ID求助

我之前在处理Google Calendar同步事件的时候也踩过这个坑，刚好能帮到你。你遇到的问题核心在于两种不同格式的事件ID对应了不同类型的日历事件，而CalendarApp.getEventById()只能识别其中一种。

为什么部分ID检索返回null？ #

你看到的两种ID格式对应两类事件：

1. 带@google.com的ID：这是Google Calendar原生创建的事件的ID，这类事件是直接在Google Calendar里生成的，CalendarApp.getEventById()可以正常识别。
2. 超长的十六进制格式ID：这是从外部日历（比如Outlook/Exchange）同步过来的事件的原始ID。这类事件不是Google Calendar原生的，CalendarApp的API无法直接通过这个原始ID检索到它们。

Google Calendar在同步外部事件时，会保留原系统的事件ID，但CalendarApp.getId()返回的是这个原始ID，而非Google为同步事件生成的内部ID，所以用getEventById()自然查不到。

解决方案 #

根据你的需求，有两种处理方式：

1. 只保留原生Google事件的ID #

如果你只需要操作Google自己创建的事件，可以在收集ID时过滤掉非原生格式的ID：

var eventList = CalendarApp.getDefaultCalendar().getEvents();
var eventIdList = [];

eventList.forEach(function(event) {
  var eventId = event.getId();
  // 只保留Google原生格式的事件ID
  if (eventId.includes('@google.com')) {
    eventIdList.push(eventId);
  }
});

// 后续检索时就不会出现null的情况
var targetEvent = CalendarApp.getEventById(eventIdList[0]);

2. 处理同步的外部事件 #

如果你需要操作这些同步过来的事件，就得改用Google Calendar Advanced Service（这是更底层的API，支持操作同步事件）：

• 第一步：在Apps Script编辑器里启用该服务：点击顶部菜单栏的「资源」→「高级Google服务」，找到「Calendar API」并开启，同时确保右侧的API状态是「已启用」。
• 第二步：用以下代码检索同步事件：

function getSyncedEventById(eventId) {
  try {
    // 获取默认日历的ID
    var calendarId = CalendarApp.getDefaultCalendar().getId();
    // 用Calendar API检索事件
    var event = Calendar.Events.get(calendarId, eventId);
    return event;
  } catch (error) {
    console.log('检索失败：' + error.message);
    return null;
  }
}

// 使用示例
var longFormatId = '040000008200E00074C5B7101A82E008000000001022931735E6D3010000000000000000100000000A762C897D92624C8F7D59B232FEEED2';
var syncedEvent = getSyncedEventById(longFormatId);
if (syncedEvent) {
  console.log('事件标题：' + syncedEvent.summary);
}

额外提醒 #

• 如果你是在处理共享日历的事件，还要确保你的账号有该日历的编辑权限，否则即使ID正确也可能检索失败。
• 对于同步事件，你可以通过event.getOriginalCalendarId()方法确认它是否来自外部同步的日历，这也能帮你提前判断该用哪种方式检索。

内容的提问来源于stack exchange，提问作者Java-K