如何通过Google Script快速将最新创建的Google Calendar事件添加到Google Sheet

核心方案：利用Calendar事件触发器 + 事件ID去重 #

无需遍历所有事件，直接通过监听Calendar的事件创建动作，结合事件ID做唯一标识避免重复，这是最高效的实现方式，具体步骤如下：

1. 创建安装式触发器监听Calendar事件 #

你需要创建一个安装式 onChange 触发器，指定触发源为目标日历，仅在新事件创建时触发同步逻辑。

代码示例：

// 辅助函数：仅需运行一次，用于创建触发器
function createCalendarTrigger() {
  const calendarId = "你的目标日历ID"; // 从Calendar设置的「共享和设置」底部获取
  ScriptApp.newTrigger("syncNewEventToSheet")
    .forUserCalendar(calendarId)
    .onEventUpdated()
    .create();
}

// 触发器触发时执行的同步函数
function syncNewEventToSheet(e) {
  // 仅处理新创建的事件，排除编辑已有事件的情况
  if (e.changeType !== "CREATED") return;
  
  // 通过事件ID直接获取新事件详情
  const targetCalendar = CalendarApp.getCalendarById(e.calendarId);
  const newEvent = targetCalendar.getEventById(e.eventId);
  
  // 打开目标Sheet
  const targetSheet = SpreadsheetApp.openById("你的Sheet ID").getActiveSheet();
  
  // 检查Sheet中是否已存在该事件ID（避免重复同步）
  const existingEventIds = targetSheet.getRange(2, targetSheet.getLastColumn(), targetSheet.getLastRow()-1, 1)
    .getValues()
    .flat();
  if (existingEventIds.includes(e.eventId)) return;
  
  // 提取需要的事件字段（可根据需求调整）
  const eventData = [
    newEvent.getTitle(),
    newEvent.getStartTime(),
    newEvent.getEndTime(),
    newEvent.getDescription(),
    newEvent.getLocation(),
    e.eventId // 将事件ID存入最后一列，用于后续去重判断
  ];
  
  // 将数据追加到Sheet末尾
  targetSheet.appendRow(eventData);
}

2. 关键细节说明 #

• 触发器精准触发：使用onEventUpdated触发器，通过e.changeType过滤出CREATED类型的事件，只处理新创建的条目，完全避开编辑操作的干扰。
• 零全量遍历：触发器触发时直接拿到新事件的ID，通过ID直接获取事件详情，无需遍历整个日历的事件集合。
• 轻量去重：仅读取Sheet中已存的事件ID列做判断，比遍历所有行或全量日历事件高效得多。

3. 替代方案：权限受限无法使用安装式触发器 #

如果因权限问题无法创建安装式触发器，可以用时间驱动触发器，每次仅拉取最近N小时内创建的事件，结合ID去重：

function syncRecentEvents() {
  const calendar = CalendarApp.getCalendarById("你的目标日历ID");
  const sheet = SpreadsheetApp.openById("你的Sheet ID").getActiveSheet();
  const existingIds = sheet.getRange(2, sheet.getLastColumn(), sheet.getLastRow()-1, 1)
    .getValues()
    .flat();
  
  // 拉取最近1小时内创建的事件（可根据需求调整时间范围）
  const startTime = new Date();
  startTime.setHours(startTime.getHours() - 1);
  const recentEvents = calendar.getEvents(startTime, new Date(), {createdTime: startTime});
  
  recentEvents.forEach(event => {
    const eventId = event.getId();
    if (!existingIds.includes(eventId)) {
      const eventData = [
        event.getTitle(),
        event.getStartTime(),
        event.getEndTime(),
        event.getDescription(),
        event.getLocation(),
        eventId
      ];
      sheet.appendRow(eventData);
    }
  });
}

创建一个时间驱动触发器（比如每15分钟运行一次），这种方式比全量遍历日历事件高效很多，仅处理极小时间范围内的事件。

常见问题解决 #

• 日历ID获取：打开Google Calendar，进入目标日历的「设置和共享」页面，拉到最底部即可看到「日历ID」。
• 权限问题：创建触发器时需要授权，确保你的账号拥有目标日历的编辑权限和Sheet的编辑权限。

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