Google Sheets日历自动同步脚本报错及嘉宾添加问题求助

问题1：触发限流报错，新增行无法同步 #

原因 #

原脚本每次运行都会遍历所有行（包括已创建过事件的旧行），重复调用Calendar API创建事件，短时间内请求次数超过Google的API限流阈值，导致报错。仅添加Utilities.sleep(3000)无法解决，因为重复请求的核心问题没得到处理。

解决方案 #

• 新增标记列（比如F列），用“已同步”标记已处理的行，每次仅处理未标记的行
• 在循环内添加合理延迟，降低API请求频率

问题2：嘉宾邮箱未被添加到事件中 #

原因 #

1. createEvent的guests参数要求是逗号分隔的邮箱字符串，若单元格格式不符合（比如用分号分隔）会导致参数无效
2. 默认情况下，创建事件不会自动发送邀请，需要显式设置sendInvites: true，否则嘉宾不会出现在事件参与者列表中

解决方案 #

• 确保嘉宾邮箱单元格为逗号分隔格式（如user1@example.com,user2@example.com）
• 在事件配置选项中添加sendInvites: true参数

修改后的完整脚本 #

function scheduleShifts() {
  // 获取当前工作表与日历ID
  var spreadsheet = SpreadsheetApp.getActiveSheet();
  var calendarId = spreadsheet.getRange("A1").getValue();
  var eventCal = CalendarApp.getCalendarById(calendarId);

  // 获取包含标记列的所有数据（A3:F，F列为同步标记）
  var signups = spreadsheet.getRange("A3:F").getValues();

  // 遍历仅处理未标记的行
  for (var x = 0; x < signups.length; x++) {
    var shift = signups[x];
    // 跳过空行或已同步的行
    if (!shift[0] || (shift[5] && shift[5] === "已同步")) continue;

    var startTime = shift[0];
    var endTime = shift[1];
    var title = shift[2];
    var guests = shift[3];
    var location = shift[4];

    // 创建事件并添加嘉宾、发送邀请
    eventCal.createEvent(title, startTime, endTime, {
      guests: guests,
      location: location,
      sendInvites: true
    });

    // 标记当前行为已同步
    spreadsheet.getRange(x + 3, 6).setValue("已同步");
    // 延迟5秒，避免触发API限流
    Utilities.sleep(5000);
  }
}

function onOpen() {
  var ui = SpreadsheetApp.getUi();
  ui.createMenu('Sync to Calendar')
    .addItem('Schedule shifts now','scheduleShifts')
    .addToUi();
}

脚本说明 #

1. 避免重复创建：通过F列的“已同步”标记，跳过已处理的行，从根本上减少API请求次数
2. 合理延迟：每次创建事件后延迟5秒，符合Google API的速率限制要求
3. 嘉宾邀请：添加sendInvites: true确保嘉宾被添加并收到邀请邮件
4. 空行处理：跳过空行，避免无意义的API调用

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