求助：如何使Google Calendar的Events: watch功能正常工作？

我明白你现在的需求和困境——想通过Google Calendar的Events: watch接口监听日历 aperam.com_el6rl85svu9af6k8cvo18k1gtg@group.calendar.google.com 的活动地点修改，然后给修改者发送通知，但测试这个功能时碰了壁，还出现了错误。下面我一步步帮你梳理问题、解决问题：

一、先把Events: watch的基础配置做对 #

Events: watch要正常工作，几个关键环节绝对不能错：

• 必填参数不能少：调用接口时必须传这几个核心参数：
  • id：给你的订阅起一个唯一标识（比如location-change-monitor-001）
  • type：固定用web_hook（这是接收推送的方式）
  • address：能被公网访问的Webhook地址（Google需要把推送消息发到这里）
  • resource：指定要监听的日历ID，也就是你提供的那个group日历ID
    示例请求体如下：

  {
    "id": "location-change-monitor-001",
    "type": "web_hook",
    "address": "https://your-public-domain/calendar-webhook",
    "resource": {
      "id": "aperam.com_el6rl85svu9af6k8cvo18k1gtg@group.calendar.google.com"
    }
  }
  

• Webhook地址必须通过验证：Google会先给你的address发一个GET请求，附带hub.challenge参数，你必须原封不动返回这个参数的内容，才能完成订阅。这一步没做的话，订阅直接失败。
• 权限要足够：确保你的OAuth2令牌有https://www.googleapis.com/auth/calendar权限（至少也要有calendar.readonly，但要发通知可能需要更高权限），而且令牌是有效的，没有过期。

二、怎么检测地点修改的事件 #

当Events: watch推送给你消息时，里面只会有基本的更新提示，你需要自己做进一步判断：

1. 在Webhook接收端解析推送里的resourceUri，用这个地址调用Events.get接口，获取活动的完整详情
2. 对比活动的location字段和你之前存储的旧值（你需要自己维护活动的历史地点记录，或者通过活动的updated时间戳结合版本号来判断是否有修改）
3. 如果确认地点被修改了，活动的lastModifiedBy字段会包含修改者的邮箱和名称，这就是你要通知的对象

三、给修改者发送通知的方法 #

确认地点修改后，你可以用这些方式发通知：

• 用Gmail API给lastModifiedBy.email发送邮件，说明活动地点被修改的具体内容
• 如果是公司内部日历，也可以用Google Chat API给对应用户发送消息

四、测试失败的常见排查点 #

如果测试时没收到推送，或者出现错误，先检查这些地方：

• Webhook地址是不是能被公网访问：本地localhost肯定不行，你可以用ngrok之类的工具做内网穿透，或者把Webhook部署到公网服务器上
• 订阅是不是过期了：Events: watch的订阅默认有效期只有7天，需要定期刷新订阅
• 看具体错误信息：在API Explorer里查看错误日志，比如是不是权限不足、参数格式错了，或者你的Webhook返回了非200的状态码
• 日历权限有没有问题：确保你的服务账号或OAuth账号有访问这个group日历的权限（至少是编辑者权限）

五、测试小技巧 #

1. 先用API Explorer调用Events.list获取一个活动的ID，手动修改这个活动的地点，然后看Webhook能不能收到推送
2. 用Postman或者curl模拟Google的验证请求，确保你的Webhook端点能正确返回hub.challenge
3. 去Google Cloud Console查看API日志，里面会记录推送的状态和具体错误，帮你快速定位问题

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