Google Calendar Events.patch无报错但未更新recurrence rule问题咨询

我在Google Apps Script中尝试更新重复事件的recurrence规则，逻辑和在UI里修改重复结束日期后点击「所有事件」一致：

• 加载系列中的首个事件，调用Calendar.Events.patch传入新的recurrence规则（原规则是每周五、共10次）
• 调用无报错，但返回的事件完全没变化
• 用API Explorer手动复制规则做同样操作，结果一样：显示执行成功，但旧规则仍保留，新规则未生效，且无报错提示

API Explorer中除事件ID和日历ID外，唯一修改的内容为：

{  
  "recurrence": [
    "RRULE:FREQ=WEEKLY;WKST=MO;UNTIL=20220921T102754Z;BYDAY=FR"
  ]
}

我的目标是编写脚本，清理会议室资源中超出预订窗口的预订。Apps Script内置的RRULE方法无法仅修改规则，必须获取/设置大量其他事件数据，我希望能在保留RRULE其他规则的前提下，将结束日期尽可能贴近预订窗口末尾。

附上相关脚本代码：

function cleanRoom() {
  resourceId = "\"id@resource.calendar.google.com\"" // 测试会议室
  let bulkevents = JSON.parse(Calendar.Events.list("\"id2@resource.calendar.google.com\""));
  let allevents = bulkevents.items.filter(function (e) {
    return e.recurrence != undefined // 筛选所有带重复规则的事件
  });
  console.log('所有带重复规则的事件:\n\n');
  // 查找重复事件中超出预订窗口的实例
  for (const x of allevents) {
    const startDT = new Date(x.start.dateTime); // 示例: 2022-07-28T07:45:00-05:00
    const title = x.summary;
    // 加载实例——重复事件在日历上显示的条目，关联到原始事件
    console.log(title);
    const instances = Calendar.Events.instances(resourceId,x.id);
    for (const i of instances.items) {
      // 从实例列表中找出超出预订窗口的条目
      // 别忘了在config.js里确认预订窗口设置正确
      if (luxon.DateTime.fromISO(i.start.dateTime) > luxon.DateTime.now().plus({ weeks: bookingWindow })) {
        // 获取原始日历事件以修改结束日期
        let offendingEvent = Calendar.Events.get(resourceId,i.recurringEventId);
        let rrule = offendingEvent.recurrence[0];
        console.log(rrule);        
        // 获取格式正确的最后有效日期
        let correctUntilDate = luxon.DateTime.now().plus({ weeks: bookingWindow });
        // 需要修改原始事件/所有事件
        if (rrule.includes("\"COUNT\"")) {
          let regrule = /COUNT=\d\d/;
          let new_rrule = rrule.replace(regrule,'UNTIL='+correctUntilDate.set({seconds: 0}).toFormat("\"yyyyMMdd'T'HHmmss'Z'\""));
          console.log(i);
          console.log(new_rrule);
          const calPatch = {
            recurrence: [new_rrule],
            end: {
              dateTime: i.end.dateTime,
              timeZone: i.end.timeZone
            },
            start: {
              dateTime: i.start.dateTime,
              timeZone: i.start.timeZone
            }
          };
          const result = Calendar.Events.update(calPatch,resourceId,offendingEvent.id);
          
          console.log(result);
          break;
        }
        break; // 不用扫描每个事件的所有实例，修复完成就处理下一个
      }
    }
  }
}

核心原因：RRULE格式错误+冗余字段传递 #

1. RRULE包含无效引号：你生成的新规则里，给UNTIL的日期值加了多余双引号（比如UNTIL="20220921T102754Z"），但Google Calendar的RRULE不允许给UNTIL值加引号，API会静默忽略这个无效规则，既不报错也不生效。
2. 错误传递单个实例的start/end：调用Calendar.Events.update时传入了单个实例的时间信息，这会强制将重复事件转为单次事件，反而破坏了修改重复规则的逻辑。
3. 正则匹配范围过窄：原正则/COUNT=\d\d/只能匹配两位数字的COUNT值，无法处理超过99次的重复事件。

修复后的关键代码 #

// 修正RRULE生成逻辑
if (rrule.includes("COUNT")) { // 去掉判断里的多余引号
  let regrule = /COUNT=\d+/; // 匹配任意位数的数字
  // 生成不带引号的UNTIL值
  let new_rrule = rrule.replace(regrule,'UNTIL='+correctUntilDate.set({seconds: 0}).toFormat("yyyyMMdd'T'HHmmss'Z'"));
  console.log(new_rrule);
  // 只传递需要修改的recurrence字段，避免破坏重复事件结构
  const calPatch = {
    recurrence: [new_rrule]
  };
  // 优先用patch而非update，仅修改指定字段更安全
  const result = Calendar.Events.patch(calPatch, resourceId, offendingEvent.id);
  console.log(result);
  break;
}

额外优化点 #

• 调用Calendar.Events.list时无需JSON.parse，该方法本身返回的就是对象，不是JSON字符串
• 确保bookingWindow变量已正确定义，避免未定义错误
• 确认脚本已获得Calendar API的修改权限，否则无法修改会议资源

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