Google Sheets同步Google Calendar脚本报错及重复事件求助

问题根因 #

• 报错Exception: The parameters (String,String,String,(class)) don't match the method signature for CalendarApp.Calendar.createEvent的原因：createEvent方法要求第二个、第三个入参必须是Date类型的时间对象，原脚本直接读取表格单元格拿到的是格式化后的字符串值，参数类型不匹配所以触发报错。
• 重复生成日历事件的原因：原脚本没有做旧数据清理/重复校验逻辑，每次运行都会遍历所有行全量创建新事件，每运行一次就会多生成一批重复日程。
• 原脚本附带的myFunction还存在变量未定义的bug：scheduling、des两个变量没有提前声明，运行时也会报错。

本次修复采用你提到的「先删除排班覆盖时段的旧日程，再全量重建新日程」的方案，逻辑简单稳定性高，不需要维护复杂的事件ID映射，适合零基础使用。

修复后完整代码 #

// ========== 配置项 请根据你的实际情况修改 ==========
const CALENDAR_ID = "scheduling.ohiolegacy@gmail.com"; // 替换为你的目标日历ID，自有日历可直接填对应邮箱
const SHEET_NAME = "Sheet1"; // 替换为你存放排班数据的工作表名称
// =================================================

// 日历日程导出到表格功能（修复原myFunction的变量未定义问题）
function exportCalendarToSheet() {
  const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(SHEET_NAME);
  const cal = CalendarApp.getOwnedCalendarById(CALENDAR_ID);
  // 按需修改要导出的日历时间范围
  const timeRangeStart = new Date("2022-07-01");
  const timeRangeEnd = new Date("2022-07-31");
  const events = cal.getEvents(timeRangeStart, timeRangeEnd);
  
  // 清空之前导出的旧数据
  ss.getRange("A2:E").clearContent();
  for(let i = 0; i < events.length; i++){
    const eventTitle = events[i].getTitle();
    const eventStart = events[i].getStartTime();
    const eventEnd = events[i].getEndTime();
    const eventLoc = events[i].getLocation();
    const eventDesc = events[i].getDescription();

    ss.getRange(i+2, 1).setValue(eventTitle);
    ss.getRange(i+2, 2).setValue(eventStart).setNumberFormat("mm/dd/yyyy hh:mm");
    ss.getRange(i+2, 3).setValue(eventEnd).setNumberFormat("mm/dd/yyyy hh:mm");
    ss.getRange(i+2, 4).setValue(eventLoc);
    ss.getRange(i+2, 5).setValue(eventDesc);
  }
}

// 排班同步到日历主功能
function addEvents(){
  const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(SHEET_NAME); 
  const lastRow = ss.getLastRow();
  // 表格无排班数据时直接退出运行
  if (lastRow < 2) return;
  const cal = CalendarApp.getOwnedCalendarById(CALENDAR_ID);
  const sheetData = ss.getRange("A2:E" + lastRow).getValues();

  // 第一步：计算当前所有排班覆盖的时间范围，删除范围内旧排班日程，避免重复
  let minTime = new Date(sheetData[0][1]);
  let maxTime = new Date(sheetData[0][2]);
  sheetData.forEach(row => {
    const rowStart = new Date(row[1]);
    const rowEnd = new Date(row[2]);
    if (rowStart < minTime) minTime = rowStart;
    if (rowEnd > maxTime) maxTime = rowEnd;
  });
  // 时间范围前后各加1天缓冲，避免漏删跨天日程
  minTime.setDate(minTime.getDate() - 1);
  maxTime.setDate(maxTime.getDate() + 1);
  const oldScheduleEvents = cal.getEvents(minTime, maxTime);
  oldScheduleEvents.forEach(event => event.deleteEvent());

  // 第二步：逐行创建新的排班日程
  sheetData.forEach(row => {
    const [title, startTime, endTime, location, description] = row;
    // 跳过标题、时间为空的无效行
    if (!title || !startTime || !endTime) return;
    // 将表格读取到的时间转换为合法Date对象，解决参数类型不匹配报错
    const eventStart = new Date(startTime);
    const eventEnd = new Date(endTime);
    // 调用接口创建日程
    cal.createEvent(
      title,
      eventStart,
      eventEnd,
      {
        location: location || "",
        description: description || ""
      }
    );
  });
}

操作步骤 #

• 打开你的排班Google Sheets，点击顶部菜单栏「扩展程序」→「Apps 脚本」，删除编辑器里原有的全部旧代码，粘贴上面的修复后代码
• 修改代码最上方配置项里的CALENDAR_ID和SHEET_NAME为你自己的实际参数
• 点击编辑器顶部的运行按钮，选择addEvents函数，按照弹窗提示完成Google账号授权：如果提示「Google未验证此应用」，点击「高级」→「转到（你的脚本名称）」即可继续完成授权
• 配置自动触发：点击Apps Script页面左侧边栏的时钟图标（触发器菜单），点击「添加触发器」，按以下参数配置：
  • 选择要运行的函数：addEvents
  • 选择部署版本：Head
  • 选择事件来源：从电子表格
  • 选择事件类型：编辑时
  • 失败通知设置按需选择即可，最后点击保存

注意：请确保表格里B列（开始时间）、C列（结束时间）的内容是Google Sheets可识别的日期/时间格式，不要输入纯文本格式的时间，否则会导致时间转换失败。首次正式使用前建议先用新建的测试日历试跑，避免误删正式日历的原有日程。

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