使用Apps Script获取Google Calendar最新创建/修改事件的最优方案

不用全量拉取时间段事件比对，直接利用onChange触发时的事件参数精准获取目标事件，是效率最高的实现方式，具体步骤如下：

1. 解析触发事件的核心参数 #

当脚本由Calendar onChange事件触发时，传入的事件对象e包含三个关键信息：

• e.changeType：明确变更类型，可选值为CREATED（新建）、UPDATED（修改）、DELETED（删除）
• e.resourceId：对应变更事件的唯一ID
• e.calendarId：目标日历的ID

这些参数直接帮你锁定变更的单个事件，无需遍历批量事件。

2. 精准获取变更事件 #

根据你的需求选择CalendarApp或Calendar高级服务：

• 使用CalendarApp（适合常规场景）：

  const targetCalendar = CalendarApp.getCalendarById(e.calendarId);
  const changedEvent = targetCalendar.getEventById(e.resourceId);
  

• 使用Calendar高级服务（适合复杂字段需求）：
  先在Apps Script编辑器中启用Calendar高级服务，然后调用：

  const changedEvent = Calendar.Events.get(e.calendarId, e.resourceId);
  

3. 规则校验与表格同步 #

获取事件后，按你的预约规则校验，再同步到表格：

• 新建事件：直接将符合规则的事件信息追加到表格
• 修改事件：通过事件ID匹配表格中已有记录，更新对应字段
• 删除事件：根据事件ID找到表格中的条目并删除

完整示例代码 #

function handleCalendarChange(e) {
  // 跳过非事件变更（比如日历设置修改）
  const validChangeTypes = ['CREATED', 'UPDATED', 'DELETED'];
  if (!validChangeTypes.includes(e.changeType)) return;

  const sheetId = '你的表格ID';
  const sheet = SpreadsheetApp.openById(sheetId).getSheetByName('预约记录');
  const eventId = e.resourceId;

  // 处理删除事件
  if (e.changeType === 'DELETED') {
    const data = sheet.getDataRange().getValues();
    const deleteRow = data.findIndex(row => row[3] === eventId) + 1; // 假设第4列存事件ID
    if (deleteRow > 0) sheet.deleteRow(deleteRow);
    return;
  }

  // 获取事件对象
  const calendar = CalendarApp.getCalendarById(e.calendarId);
  const event = calendar.getEventById(eventId);
  if (!event) return;

  // 校验特定规则：示例为标题包含「预约」关键词
  if (!event.getTitle().includes('预约')) return;

  // 提取需要的预约信息
  const eventInfo = [
    event.getTitle(),
    event.getStartTime(),
    event.getEndTime(),
    eventId,
    event.getDescription() || '无描述'
  ];

  // 处理新建/修改事件
  if (e.changeType === 'CREATED') {
    sheet.appendRow(eventInfo);
  } else if (e.changeType === 'UPDATED') {
    const data = sheet.getDataRange().getValues();
    const updateRow = data.findIndex(row => row[3] === eventId) + 1;
    if (updateRow > 0) {
      sheet.getRange(updateRow, 1, 1, eventInfo.length).setValues([eventInfo]);
    }
  }
}

额外优化建议 #

• 增加try-catch块，处理事件已被删除、权限不足等异常情况
• 若需处理多个日历，可通过e.calendarId区分目标日历
• 对于高频变更场景，可添加执行锁避免并发冲突

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