Google Apps Script超时请求：优化GCal导出到GSheet脚本方案

一、减少重复API调用 #

• 原代码中events.reverse().reduce里错误使用events[i]获取事件数据，不仅索引匹配混乱，还重复触发事件属性读取，直接用迭代的e对象即可：

  // 原错误写法
  o.v.push([mycal, events[i].getTitle(), ...])
  // 优化后
  o.v.push([mycal, e.getTitle(), e.getDescription(), ...])
  

• 缓存重复使用的日历和表格对象：多个sheet对应同一邮箱时，提前调用CalendarApp.getCalendarById和ss.getSheetByName并缓存，避免循环内重复发起API请求。

二、用批量操作替代零散操作 #

• 替换表格公式为脚本计算：原代码用单元格公式计算时长，改成在脚本中直接计算数值，减少表格加载和计算压力：

  // 原公式写法
  var f = `=(HOUR(F${row})+(MINUTE(F${row})/60))-(HOUR(E${row})+(MINUTE(E${row})/60))`;
  // 优化后直接计算小时数
  var duration = (e.getEndTime().getTime() - e.getStartTime().getTime()) / (1000 * 60 * 60);
  

• 合并数据写入和格式设置：尽量减少setValues、setBackgrounds等Spreadsheet API调用次数，一次性完成数据写入和格式配置。

三、优化数据处理逻辑 #

• 缩小事件查询范围：如果1年的事件数据量过大，拆分查询区间（比如按月分批次获取），避免一次性加载过多数据导致内存溢出或超时。
• 移除不必要的数组反转：events.reverse()若不是业务必需，直接按原顺序处理，减少数组操作的性能开销。
• 用for循环替代reduce：数据量大时，普通for循环的执行效率比reduce更高，能降低脚本运行时间。

四、修正细节错误 #

• 原obj数组中存在拼写错误mmycal，修正为mycal，避免无效的日历API调用。

优化后的完整代码示例 #

function export_gcal_to_gsheet() {
  // 修正拼写错误
  var obj = [{ mycal: "Email", sheetName: "a" },{ mycal: "Email", sheetName: "b"  },{ mycal: "Email", sheetName: "c"  },{ mycal: "Email", sheetName: "d"  },{ mycal: "email", sheetName: "e" },{ mycal: "email", sheetName: "f" }];
  var colors = Calendar.Colors.get().calendar;
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  
  // 提前缓存日历和表格对象
  var calMap = {};
  var sheetMap = {};
  obj.forEach(item => {
    if (!calMap[item.mycal]) {
      calMap[item.mycal] = CalendarApp.getCalendarById(item.mycal);
    }
    sheetMap[item.sheetName] = ss.getSheetByName(item.sheetName);
  });

  const startDate = new Date("July 01, 2022 00:00:00 UTC");
  const endDate = new Date("June 30, 2023 00:00:00 UTC");
  const header = ["Calendar Address", "Event Title", "Event Description", "Event Location", "Event Start", "Event End", "Calculated Duration", "Visibility", "Date Created", "Last Updated", "MyStatus", "Created By", "All Day Event", "Recurring Event", "Color"];
  const offset = 6;

  obj.forEach(({ mycal, sheetName }) => {
    var cal = calMap[mycal];
    var events = cal.getEvents(startDate, endDate);
    var sheet = sheetMap[sheetName];
    sheet.clearContents();
    var calColor = cal.getColor();

    var values = [header];
    var backgrounds = [];

    // 用for循环提升性能
    for (let i = 0; i < events.length; i++) {
      const e = events[i];
      const color = e.getColor();
      const bgColor = colors[color] ? colors[color].background : calColor;
      // 直接计算时长
      const duration = (e.getEndTime().getTime() - e.getStartTime().getTime()) / (1000 * 60 * 60);
      
      values.push([
        mycal,
        e.getTitle(),
        e.getDescription(),
        e.getLocation(),
        e.getStartTime(),
        e.getEndTime(),
        duration,
        String(e.getVisibility()),
        e.getDateCreated(),
        e.getLastUpdated(),
        e.getMyStatus(),
        e.getCreators(),
        e.isAllDayEvent(),
        e.isRecurringEvent(),
        bgColor
      ]);
      backgrounds.push([bgColor]);
    }

    // 批量写入数据和设置格式
    const dataRange = sheet.getRange(offset, 1, values.length, values[0].length);
    dataRange.setValues(values);
    sheet.getRange(offset + 1, 7, values.length - 1).setNumberFormat('.00');
    sheet.getRange(offset + 1, 15, backgrounds.length).setBackgrounds(backgrounds);
  });
}

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