修改Tanaike脚本适配Excel CSV格式导入谷歌日历及问题排查

问题背景 #

基于@Tanaike的Google Apps Script脚本改造后，尝试从包含Subject、Start Date、All Day Event等字段的11列谷歌表格导入事件到谷歌日历时，遇到三个API调用错误：

1. 无法通过All Day Event布尔列设置全天事件，误以为仅存在isAllDayEvent()查询方法，无对应设置方法；
2. 调用cal.setVisibility()触发TypeError，该方法不属于日历对象，需根据Private列设置事件可见性；
3. 调用cal.addPopupReminder()触发TypeError，该方法不属于日历对象，需根据Reminder列设置弹窗提醒时长。

逐个问题的解决方案 #

问题1：设置全天事件的正确方式 #

Google Apps Script中设置全天事件有三种标准实现方式：

• 创建全新全天事件：直接使用日历对象的createAllDayEvent(title, startDate, endDate, options)方法，无需额外标记；
• 通过事件构建器配置：使用EventBuilder.setAllDay(true)方法标记事件为全天；
• 修改已有事件：对已创建的Event对象调用setAllDay(boolean)方法切换全天状态。

问题2：设置事件可见性的正确方式 #

setVisibility()是**事件对象（Event）**的专属方法，而非日历对象（Calendar）的方法。需先创建或获取目标事件，再调用该方法，参数使用CalendarApp.Visibility枚举值：

• 私有事件：CalendarApp.Visibility.PRIVATE
• 默认可见性：CalendarApp.Visibility.DEFAULT
• 公开事件：CalendarApp.Visibility.PUBLIC

问题3：添加弹窗提醒的正确方式 #

addPopupReminder(minutes)同样是**事件对象（Event）**的方法，需在创建事件后调用，传入提前提醒的分钟数（数值类型）。若使用EventBuilder构建事件，也可预先调用addPopupReminder(minutes)配置提醒。

修正后的完整脚本示例 #

function importFromSheetToCalendar() {
  // 配置项：替换为你的工作表名和日历ID
  const sheetName = "Sheet1";
  const calendarId = "your-calendar-id@group.calendar.google.com";

  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(sheetName);
  const cal = CalendarApp.getCalendarById(calendarId);
  const data = sheet.getDataRange().getValues();
  data.shift(); // 跳过表头行

  data.forEach(row => {
    // 根据你的表格列顺序调整解构字段，确保对应正确列
    const [subject, startDate, endDate, allDayEvent, isPrivate, reminderMinutes, description, location] = row;

    let event;
    // 创建全天或定时事件
    if (allDayEvent) {
      const start = new Date(startDate);
      const end = new Date(endDate);
      event = cal.createAllDayEvent(subject, start, end);
    } else {
      const start = new Date(startDate);
      const end = new Date(endDate);
      event = cal.createEvent(subject, start, end);
    }

    // 设置事件可见性
    if (isPrivate) {
      event.setVisibility(CalendarApp.Visibility.PRIVATE);
    } else {
      event.setVisibility(CalendarApp.Visibility.DEFAULT);
    }

    // 添加弹窗提醒（仅当分钟数为有效正数时）
    if (typeof reminderMinutes === "number" && reminderMinutes > 0) {
      event.addPopupReminder(reminderMinutes);
    }

    // 可选：设置事件描述和地点
    if (description) event.setDescription(description);
    if (location) event.setLocation(location);
  });

  SpreadsheetApp.getUi().alert("事件导入完成！");
}

脚本使用注意事项 #

• 确保表格列顺序与脚本中的解构顺序完全匹配；
• All Day Event列需为布尔值（TRUE/FALSE）；
• Private列建议使用布尔值，TRUE表示设置为私有事件；
• Reminder列需为数值类型，代表提前提醒的分钟数；
• 替换sheetName和calendarId为你的实际工作表名称和日历ID。

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