如何高效实现Google Calendar事件按规则导入Google Sheets？（Google Apps Script）

你的脚本功能正常，但在循环结构和执行效率上有不少优化空间，主要可以从减少循环嵌套、批量操作表格、降低查询耗时这几个方向调整：

核心优化点 #

• 合并嘉宾处理逻辑：原脚本先收集所有嘉宾邮箱再二次遍历分类，可直接在遍历嘉宾时完成员工/客户的区分，少做一次循环
• 批量写入表格数据：原脚本每次循环都单独调用setValues，频繁触发Spreadsheet API会拖慢速度，改为先把所有数据存进数组，最后一次性写入
• 用Set优化邮箱查询：把员工邮箱数组转成Set，has方法比数组includes的查询效率高得多，嘉宾多的时候差异明显
• 直接计算时长：用代码算出事件时长并格式化，替代表格公式，避免后续依赖单元格关联计算

优化后的脚本 #

function getEventsFromRangeGeneric() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getSheetByName("EventsRange");
  // 转成Set提升邮箱查询效率
  const employees = new Set(['test1@email.com','test2@email.com','test3@email.com']);
  
  // 获取日期范围
  const startDate = sheet.getRange("A2").getValue();
  const endDate = sheet.getRange("B2").getValue();
  
  // 获取日历与事件
  const calId = 'workcalendartest@group.calendar.google.com';
  const cal = CalendarApp.getCalendarById(calId);
  const events = cal.getEvents(new Date(startDate), new Date(endDate));

  // 准备表头与数据存储数组
  const header = ["Title","Name","Employee","Client","Start","End","Duration","Location"];
  const rowsData = [header]; // 先把表头放入数组

  // 遍历所有事件，一次性收集全部数据
  events.forEach(event => {
    const title = event.getTitle();
    const startTime = event.getStartTime();
    const endTime = event.getEndTime();
    // 直接计算事件时长并格式化为hh:mm:ss
    const durationMs = endTime.getTime() - startTime.getTime();
    const duration = Utilities.formatDate(new Date(durationMs), Session.getScriptTimeZone(), "HH:mm:ss");
    const location = event.getLocation();
    const guestList = event.getGuestList();
    
    const employeeEmails = [];
    const clientEmails = [];
    const clientName = ''; // 原脚本未填充该字段，保留占位

    // 遍历嘉宾时直接完成分类，合并两次循环为一次
    guestList.forEach(guest => {
      const email = guest.getEmail();
      employees.has(email) ? employeeEmails.push(email) : clientEmails.push(email);
    });

    // 将当前事件数据加入数组（邮箱数组转成逗号分隔字符串，表格显示更友好）
    rowsData.push([
      title,
      clientName,
      employeeEmails.join(','),
      clientEmails.join(','),
      startTime,
      endTime,
      duration,
      location
    ]);
  });

  // 清空原有数据（可选，根据需求决定是否保留历史数据）
  sheet.getRange(5, 1, sheet.getLastRow() - 4, 8).clearContent();
  
  // 一次性写入所有数据，大幅提升执行效率
  if (rowsData.length > 1) {
    sheet.getRange(5, 1, rowsData.length, rowsData[0].length).setValues(rowsData);
    // 统一设置时长列格式
    sheet.getRange(5, 7, rowsData.length, 1).setNumberFormat('hh:mm:ss');
  }
}

优化说明 #

1. 循环简化：把原有的“收集邮箱→分类”两次循环合并成一次，逻辑更紧凑，减少不必要的数组操作
2. 性能提升：批量写入避免了多次调用Spreadsheet API的开销，Set查询也降低了邮箱判断的耗时
3. 数据友好性：员工/客户邮箱数组转成逗号分隔字符串，不会在表格里显示成[object Array]的奇怪格式
4. 逻辑独立：用代码计算时长，不再依赖表格公式，数据导出后无需担心单元格引用错误

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