Angular+TS调用Google Calendar API创建外出事件取消预约方法

你之前构造的事件参数缺了Google Calendar v3接口识别「外出（OOO）」事件的两个核心必填字段：只要eventType保持默认的default值，哪怕日程标题写了Out of Office，接口也只会创建普通日程，完全不会触发平台内置的自动取消时段内预约的逻辑。从你贴的配置截图里也能看到没有加这两个特殊字段，达不到预期效果是必然的。

首先提前确认两点前置准备：

• 已经完成Google账号鉴权，申请的API权限范围包含https://www.googleapis.com/auth/calendar.events写权限
• 项目里已经正确加载gapi的Calendar v3客户端（不管是直接引入gapi脚本，还是用Angular生态的第三方gapi封装库都可以）

直接用下面的方法构造参数调用接口即可：

/**
 * 创建外出（OOO）日程，自动拒绝时段内所有预约
 * @param startTime 日程开始时间，RFC3339格式（即Date对象toISOString()的返回格式）
 * @param endTime 日程结束时间，RFC3339格式
 * @param declineMessage 自动拒绝会议时返回给发起者的提示文案
 */
const createOutOfOfficeEvent = async (
  startTime: string,
  endTime: string,
  declineMessage: string = "当前处于外出时段，无法参会，已自动拒绝本次预约。"
) => {
  const eventResource = {
    summary: "Out of office",
    description: "外出时段，自动拒绝所有会议邀请",
    start: {
      dateTime: startTime,
      timeZone: Intl.DateTimeFormat().resolvedOptions().timeZone // 自动读取用户本地时区，也可手动传值如'Asia/Shanghai'
    },
    end: {
      dateTime: endTime,
      timeZone: Intl.DateTimeFormat().resolvedOptions().timeZone
    },
    // 核心配置1：必须显式声明事件类型为outOfOffice，不能用默认default
    eventType: "outOfOffice",
    // 核心配置2：必须传入外出属性配置自动拒约规则，缺了这个就不会触发自动取消预约逻辑
    outOfOfficeProperties: {
      autoDeclineMode: "declineAllInvitations",
      declineMessage: declineMessage
    },
    // 常规配置：日程时间段标记为忙碌
    transparency: "opaque"
  };

  return gapi.client.calendar.events.insert({
    calendarId: "primary", // 默认操作用户主日历，需要改其他日历替换对应ID即可
    resource: eventResource
  }).then(res => {
    console.log("外出日程创建成功", res.result);
    return res.result;
  }).catch(err => {
    console.error("创建外出日程失败", err);
    throw err;
  });
};

• 网上很多老教程只提了要设eventType: "outOfOffice"，没提outOfOfficeProperties字段：2022年之后Google就把自动拒约的逻辑全部收敛到这个字段下了，缺了这个字段哪怕eventType写对了，创建的也只是个带外出标识的普通日程，不会自动拒会。
• autoDeclineMode有两个可选值：
  • declineAllInvitations：拒绝该时段内所有新邀请，同时自动拒绝已经存在的所有该时段预约，也就是你要的自动取消所有时段内预约的效果
  • declineOnlyNewInvitations：仅拒绝新收到的邀请，不会改动已经确认参会的现有预约，按需选择即可
• 不要自己写逻辑遍历时段内所有事件手动改参会状态：官方内置的OOO事件逻辑会自动处理跨日历、重复会议、权限等边界情况，自己写逻辑很容易漏场景。
• 创建完成后可以直接打开Google Calendar网页端验证，如果事件带紫色的外出标识，点进详情能看到「自动拒绝此时间段内的所有活动」的提示，就说明配置生效了。

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