通过Google Apps Script创建日历事件后无法发送邀请邮件求助

可能的原因及对应解决方案 #

1. 触发器权限限制（最常见） #

原脚本使用简单onEdit触发器，运行时继承表格编辑者的权限。若编辑者无目标日历的管理权限或发送邀请权限，会导致邀请邮件无法触发。

解决办法：

• 删除原简单触发器，创建可安装的编辑触发器，以脚本所有者权限运行：
  1. 打开脚本编辑器，点击左侧「触发器」图标
  2. 点击「添加触发器」
  3. 选择函数：onConfirmedEdit
  4. 事件来源选「电子表格」，事件类型选「编辑时」
  5. 保存并完成授权

2. 参数格式错误 #

原脚本中guests参数用join()转换为字符串，而CalendarApp支持直接传入数组，格式错误可能干扰邀请逻辑；同时原脚本未将location加入事件选项（不影响邀请，但属于功能缺失）。

修改后的CalendarApp版本脚本：

function onConfirmedEdit(e) {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getActiveSheet();
  const row = e.range.getRow();
  
  if (e.range.columnStart === 14 && e.value === "Confirmed") {
    const showDate = sheet.getRange(row, 6).getValue();
    
    if (showDate instanceof Date) {
      const startTime = new Date(showDate);
      startTime.setHours(19, 0, 0, 0);
      const endTime = new Date(showDate);
      endTime.setHours(23, 30, 0, 0);

      const calendarId = 'xyz@example.com';
      const calendar = CalendarApp.getCalendarById(calendarId);
      const eventTitle = sheet.getRange(row, 7).getValue();
      const location = sheet.getRange(row, 10).getValue();
      const eventDescription = `This is a test event`;
      const guestlist = ['xyz2@example.com', 'xyz3@example.com', 'xyz4@example.com'];

      const eventOptions = {
        description: eventDescription,
        location: location,
        guests: guestlist, // 直接传入数组，无需转换
        sendInvites: true
      };

      const newEvent = calendar.createEvent(eventTitle, startTime, endTime, eventOptions);

    } else {
      Logger.log('Invalid show date format: ' + showDate);
    }
  }
}

3. 日历权限不足 #

确保脚本运行账户（可安装触发器所有者）对目标日历calendarId拥有：

• 日历所有者或编辑权限
• 共享设置中开启「可以更改事件并管理邀请」权限

4. 改用Google Calendar API（更可靠） #

若CalendarApp仍无法解决，直接调用Calendar API的events.insert方法，精准控制邀请逻辑：

修改后的Calendar API版本脚本：

function onConfirmedEdit(e) {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getActiveSheet();
  const row = e.range.getRow();
  
  if (e.range.columnStart === 14 && e.value === "Confirmed") {
    const showDate = sheet.getRange(row, 6).getValue();
    
    if (showDate instanceof Date) {
      const startTime = new Date(showDate);
      startTime.setHours(19, 0, 0, 0);
      const endTime = new Date(showDate);
      endTime.setHours(23, 30, 0, 0);

      const calendarId = 'xyz@example.com';
      const eventTitle = sheet.getRange(row, 7).getValue();
      const location = sheet.getRange(row, 10).getValue();
      const eventDescription = `This is a test event`;
      const guestlist = ['xyz2@example.com', 'xyz3@example.com', 'xyz4@example.com'];

      // 构造Calendar API事件对象
      const event = {
        summary: eventTitle,
        location: location,
        description: eventDescription,
        start: {
          dateTime: startTime.toISOString(),
          timeZone: Session.getScriptTimeZone()
        },
        end: {
          dateTime: endTime.toISOString(),
          timeZone: Session.getScriptTimeZone()
        },
        attendees: guestlist.map(email => ({ email: email })),
        sendUpdates: 'all'
      };

      // 调用API创建事件并发送邀请
      try {
        Calendar.Events.insert(event, calendarId, { sendNotifications: true });
        Logger.log('Event created with invites sent successfully');
      } catch (error) {
        Logger.log('Error creating event: ' + error.message);
      }

    } else {
      Logger.log('Invalid show date format: ' + showDate);
    }
  }
}

注意：使用前需在脚本编辑器中启用Google Calendar API（资源 → 高级Google服务 → 启用Calendar API）

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