如何优化从Google Sheets向Google Calendar批量添加日程的脚本？

你的脚本处理500条条目耗时近10分钟，核心原因是循环中每次调用createAllDayEvent和setColor都是独立的Calendar API请求，外部服务调用的延迟会随着请求次数线性叠加。下面是两种高效的提速方案：

方案一：使用Calendar Advanced Service批量插入（推荐） #

通过Calendar API的批量请求接口，将所有事件的创建请求合并为一次发送，能把耗时压缩到几十秒内。

前置步骤 #

在脚本编辑器中开启Calendar Advanced Service：

1. 点击顶部菜单「资源」→「高级Google服务」
2. 找到「Calendar API」并启用开关
3. 按照提示跳转到关联的Google Cloud项目，确认Calendar API已启用

优化后的代码 #

function batchCreateCalendarEvents() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheetByName("Entries");
  var lastRow = sheet.getLastRow();
  var calendarId = "xxxxxxxxxx"; // 替换为你的目标日历ID

  // 读取表格数据
  var data = sheet.getRange("A2:E" + lastRow).getValues();
  
  // 构建批量请求数组
  var batchRequests = data.map(row => {
    const eventTitle = row[0];
    const eventDesc = row[1];
    const eventDate = new Date(row[2]);
    const colorId = CalendarApp.EventColor[row[4]];

    // 全天事件需满足：end日期为start日期的次日（Calendar API要求）
    const startDate = eventDate.toISOString().split("T")[0];
    const endDate = new Date(eventDate);
    endDate.setDate(endDate.getDate() + 1);
    const endDateStr = endDate.toISOString().split("T")[0];

    return {
      insert: {
        resource: {
          summary: eventTitle,
          description: eventDesc,
          start: { date: startDate },
          end: { date: endDateStr },
          colorId: colorId
        }
      }
    };
  });

  // 发送批量请求
  if (batchRequests.length > 0) {
    Calendar.Events.batchInsert({ requests: batchRequests }, calendarId);
  }
}

方案二：优化现有脚本的单次请求（快速改进） #

如果暂时不想启用Advanced Service，可以将创建事件和设置颜色合并为一次API请求，减少一半的请求次数，能将耗时压缩到5分钟以内。

修改后的核心代码 #

将原循环内的两行操作合并：

// 替换原循环内的createAllDayEvent和setColor代码
cal.createAllDayEvent(data[i][0], new Date(data[i][2]), {
  description: data[i][1],
  color: CalendarApp.EventColor[data[i][4]]
});

额外注意事项 #

• 批量插入时，若需避免重复事件，可以先通过Calendar API查询已有事件，对比后再生成批量请求（会增加少量耗时，但仍远优于循环创建）
• Google Apps Script单脚本执行上限为6分钟，批量方案完全不会触发超时，而原脚本的10分钟执行可能已触发分段执行，影响效率

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