如何通过Calendar Trigger获取日历事件更新并同步至Google Sheets（App Script新手咨询）

完全可以实现这个需求，核心是借助Calendar的更改触发器，配合App Script提取事件属性并写入Sheet。下面给你一步步拆解：

1. 设置Calendar更改触发器 #

打开你的App Script项目，按以下步骤操作：

• 左侧菜单点「触发器」，点击「添加触发器」
• 选择要触发的函数（比如你可以命名为syncCalendarToSheet）
• 事件源选「来自日历」，事件类型选「日历更改」
• 选择你要监控的目标日历，保存即可

2. 编写核心处理函数 #

下面是一个适合新手的基础示例代码，你可以直接复制修改：

function syncCalendarToSheet(e) {
  // 跳过非新增/更新的事件类型（比如删除）
  if (e.changeType !== 'CREATED' && e.changeType !== 'UPDATED') return;

  // 替换成你的日历ID和Sheet ID
  const CALENDAR_ID = '你的日历ID';
  const SHEET_ID = '你的Sheet ID';
  
  // 获取事件详情
  const calendar = CalendarApp.getCalendarById(CALENDAR_ID);
  const event = calendar.getEventById(e.eventId);
  
  // 提取需要的属性
  const eventData = [
    event.getId(), // 用事件ID做唯一标识，方便后续更新
    e.changeType,
    event.getTitle(),
    event.getDescription() || '',
    event.getStartTime(),
    event.getEndTime(),
    event.getLocation() || ''
  ];

  // 写入或更新Sheet
  const sheet = SpreadsheetApp.openById(SHEET_ID).getActiveSheet();
  const dataRange = sheet.getDataRange().getValues();
  
  // 查找是否已有该事件（用于更新操作）
  const eventRowIndex = dataRange.findIndex(row => row[0] === event.getId());
  
  if (eventRowIndex === -1) {
    // 新增事件，追加到Sheet末尾
    sheet.appendRow(eventData);
  } else {
    // 更新事件，覆盖对应行
    sheet.getRange(eventRowIndex + 1, 1, 1, eventData.length).setValues([eventData]);
  }
}

3. 注意事项 #

• 首次运行脚本时，需要授权App Script访问你的日历和Google Sheets，按提示完成授权即可
• 测试时可以手动新增或修改一个日历事件，等待触发器触发（通常几秒到几十秒），然后检查Sheet是否同步成功
• 如果需要处理大量事件，注意App Script单次执行时间不能超过6分钟，若有批量需求可以拆分逻辑或用时间触发器补充

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