You need to enable JavaScript to run this app. 基于Google Apps Script的G Suite日历事件保存更新交互与接口调用插件
优惠活动
大模型
产品
解决方案
定价
更多

基于Google Apps Script的G Suite日历事件保存更新交互与接口调用插件

实现思路&落地步骤

先避第一个核心新手坑

很多人一开始会写绑定在日历上的普通Apps Script容器脚本,但这种脚本完全没权限拦截用户在Calendar原生界面的新建、编辑、保存操作,要实现需求必须开发「Google Workspace 加载项」,通过Calendar提供的扩展点嵌入原生流程,才能拿到保存操作的拦截权。

核心实现流程

  • 配置扩展触发钩子
    在项目的appsscript.json清单文件里,声明Calendar模块的「保存操作触发规则」,让加载项能在用户点Calendar原生的「保存」按钮时接管流程,而不是等事件存完了再触发。
  • 做确认弹窗
    触发钩子后,用加载项内置的CardService组件生成带「确定」「取消」两个按钮的弹窗,弹窗里可以提前显示当前待存事件的标题,降低用户误操作概率。
  • 按用户选择走分支逻辑
    • 点「取消」:直接调Calendar扩展API的cancelSave()方法掐断当前保存流程,事件根本不会被写入日历。
    • 点「确定」:先调continueSave()放行原生的事件保存动作,同时从当前操作的上下文里读取需要的三个参数,发请求到指定API即可。

核心代码参考

1. 分支动作处理逻辑

// 处理用户点击「确定」的动作
function handleConfirmAction(eventContext) {
  // 从当前操作上下文读取核心参数
  const calendarId = eventContext.calendarId;
  const eventSummary = eventContext.event.summary;
  // 记录当前操作时间为事件创建/更新时间
  const operateTime = new Date().toISOString();
  
  // 构造符合要求的请求参数
  const payload = {
    summary: eventSummary,
    created: operateTime,
    googleCalendarId: calendarId
  };
  
  // 向指定API端点发请求
  UrlFetchApp.fetch("你的目标API地址", {
    method: "POST",
    contentType: "application/json",
    payload: JSON.stringify(payload)
  });
  
  // 放行原生的事件保存流程
  CalendarExtendApp.continueSave();
}

// 处理用户点击「取消」的动作
function handleCancelAction() {
  // 直接终止保存流程,事件不会被写入日历
  CalendarExtendApp.cancelSave();
}

2. 清单文件核心配置(appsscript.json)

{
  "calendar": {
    "contingencies": [
      {
        "onInvoke": "openConfirmDialog",
        "name": "saveInterceptor"
      }
    ]
  },
  "oauthScopes": [
    "https://www.googleapis.com/auth/calendar",
    "https://www.googleapis.com/auth/script.external_request"
  ]
}

新手高频踩坑提醒

  • 别用“存完再删”的思路模拟取消逻辑:有人会写代码等事件保存成功后再调用deleteEvent()删掉,但这种方法会让事件短暂出现在日历里,甚至触发系统的事件变更通知,正确做法是用流程拦截API在写入前就终止。
  • 别把两个接口搞混:CalendarApp是用来读写已存在的日历事件数据的接口,而拦截原生保存流程的逻辑是属于CalendarExtendApp的能力,两个接口的适用场景完全不一样。
  • 权限别漏配:光申请日历读写权限不够,还要额外申请外部网络请求的权限,不然调API的时候会直接被脚本安全机制拦下来。
  • 开发阶段不用急着发布:在Apps Script编辑器里绑定Calendar的测试触发场景,就能直接调试弹窗逻辑和分支动作,不用走完整个应用发布流程。

内容的提问来源于stack exchange,提问作者MR_AMDEV

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.20 11:54:03