使用Google Apps Script修改Google日历事件忙闲状态失败求助

问题描述 #

尝试将主日历（primary）中部分事件的可见详情从Busy（忙碌）改为Free（空闲），代码执行无报错但修改不生效。修改颜色等其他属性可正常生效，使用企业账号。

复现步骤：

1. 在日历中创建一个可见详情为Busy的事件（如会议）。
2. 创建独立脚本并运行以下函数：

function test(){
  var calendar = CalendarApp.getDefaultCalendar();
  var startTime = new Date();
  var endTime = new Date();
  endTime.setDate(endTime.getDate() + 1);

  var events = calendar.getEvents(startTime, endTime);

  // 遍历每个事件
  for (var i = 0; i < events.length; i++) {
    var event = events[i];
    var eventTitle = event.getTitle();
    var eventType = event.getEventType()
    var calendarId = calendar.getId();
    var eventIdOriginal = event.getId();
    var eventId = eventIdOriginal.replace("@google.com","").toLowerCase();      
    let originalEvent = Calendar.Events.get(calendarId, eventId);

    // 第一种尝试
    originalEvent.transparency = "transparent";

    // 第二种尝试
    var changes = { transparency: "transparent" };
    try{
      //Calendar.Events.update(originalEvent, calendarId, eventId,changes);
      Calendar.Events.patch(changes,calendarId, eventId);
    }catch(e){
      Logger.log(e);
    }
  }
}

执行后无异常抛出，但事件仍显示为Busy状态。

解决方案 #

1. 确认Calendar API高级服务已启用 #

在脚本编辑器中：

• 点击扩展 → Apps Script 高级服务
• 找到Calendar API并启用开关
• 同时确保关联的Google Cloud Platform项目中已启用Calendar API（企业账号通常默认启用，若未启用需手动开启）

2. 修正API调用方式 #

使用Calendar.Events.update替代patch，或在patch中指定必要参数，以下是两种有效写法：

写法一：直接更新修改后的完整事件对象

function test(){
  var calendar = CalendarApp.getDefaultCalendar();
  var startTime = new Date();
  var endTime = new Date();
  endTime.setDate(endTime.getDate() + 1);

  var events = calendar.getEvents(startTime, endTime);

  for (var i = 0; i < events.length; i++) {
    var event = events[i];
    var calendarId = calendar.getId();
    var eventId = event.getId().replace("@google.com","").toLowerCase();      
    let originalEvent = Calendar.Events.get(calendarId, eventId);

    // 修改透明度为transparent（对应Free状态）
    originalEvent.transparency = "transparent";
    
    try{
      // 执行更新，添加sendUpdates避免发送不必要的通知
      Calendar.Events.update(originalEvent, calendarId, eventId, {sendUpdates: "none"});
      Logger.log("事件「%s」透明度修改成功", event.getTitle());
    }catch(e){
      Logger.log("修改失败：%s", e.toString());
    }
  }
}

写法二：使用patch并指定fields参数

若坚持使用patch，需明确指定要更新的字段，确保API识别修改：

function test(){
  var calendar = CalendarApp.getDefaultCalendar();
  var startTime = new Date();
  var endTime = new Date();
  endTime.setDate(endTime.getDate() + 1);

  var events = calendar.getEvents(startTime, endTime);

  for (var i = 0; i < events.length; i++) {
    var event = events[i];
    var calendarId = calendar.getId();
    var eventId = event.getId().replace("@google.com","").toLowerCase();      
    var changes = { transparency: "transparent" };
    
    try{
      // 指定fields参数，明确更新transparency字段
      Calendar.Events.patch(changes, calendarId, eventId, {fields: "transparency", sendUpdates: "none"});
      Logger.log("事件「%s」透明度修改成功", event.getTitle());
    }catch(e){
      Logger.log("修改失败：%s", e.toString());
    }
  }
}

3. 排查特殊事件限制 #

• 若事件是他人发起的会议邀请，你作为参会者可能没有权限修改其透明度，仅能修改自己的响应状态
• 重复事件需确认是否修改了系列主事件，而非单个实例

4. 验证日志信息 #

添加日志查看关键数据，帮助定位问题：

// 在获取事件后添加
Logger.log("事件ID：%s", eventId);
Logger.log("原透明度：%s", originalEvent.transparency);

运行后查看查看 → 日志，确认原透明度为opaque（对应Busy），且事件ID正确。

内容的提问来源于stack exchange，提问作者Hernán Fúquene