使用Apps Script同步Sheets到Google Calendar时遇参数不匹配错误

核心错误原因 #

你调用createEvent时犯了参数格式错误：该方法的第四个参数是包含所有选项的单一对象，但你把description和location拆成两个独立对象传入，直接导致参数签名不匹配的报错。另外，从表格读取的日期值需要确保是有效的Date类型，否则也会引发日期类参数错误。

修正后的代码 #

function addCalEvent() {
  const calendar = CalendarApp.getCalendarById('MyPRIVATECalendarID');
  const sheet = SpreadsheetApp.getActive().getSheetByName('Task_Pool');
  const schedule = sheet.getDataRange().getValues();

  // 移除前两行表头/无效数据
  schedule.splice(0, 2);

  schedule.forEach(function(row) {
    // 转换并校验日期有效性，处理表格中可能的文本格式日期
    const startDate = new Date(row[6]);
    const endDate = new Date(row[7]);

    // 跳过无效日期的行，避免执行报错
    if (isNaN(startDate.getTime()) || isNaN(endDate.getTime())) {
      console.log(`跳过无效日期行：${row}`);
      return;
    }

    // 合并所有选项到同一个对象中
    const eventOptions = {
      description: row[4] || '', // 空值时设为空字符串，避免参数异常
      location: row[5] || ''
    };

    // 正确调用createEvent方法
    calendar.createEvent(row[0], startDate, endDate, eventOptions);
  });
};

关键修正点 #

• 合并选项对象：将description和location放在同一个eventOptions对象里，作为createEvent的第四个参数传入，符合方法的参数要求。
• 日期有效性校验：用new Date()转换表格数据，通过isNaN(date.getTime())判断是否为有效日期，过滤无效数据防止报错。
• 空值处理：给description和location设置默认空字符串，避免表格对应单元格为空时传递undefined引发异常。

额外注意事项 #

1. 确保你的Google账号对目标日历有编辑权限，否则会触发权限类报错。
2. 若要避免重复创建事件，可在循环前读取已有事件的标题/日期，增加去重判断逻辑。
3. 表格中的日期列建议设置为Google Sheets的「日期」格式，这样getValues()会直接返回Date对象，减少转换问题。

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