用途:通过 Google Calendar API v3 管理日程,适用于用户提到日历、calendar.google.com、日历链接、安排会议、查看空闲时间等场景。
主要能力:列出与查看日历;列出、搜索、查看事件详情;创建事件(含全天事件、自然语言 quickAdd);更新(PUT)与部分更新(PATCH)事件;删除事件并可发送通知;管理参与者与自定义提醒;创建重复事件(RRULE)并列出实例;查询 freeBusy 空闲/忙碌;创建、更新、删除次级日历;设置事件颜色(colorId 1-11)。
使用方式:基础地址 https://www.googleapis.com/calendar/v3,请求头使用 Authorization: Bearer $GOOGLE_CALENDAR_TOKEN。主日历 ID 用 primary。日期用 RFC3339 格式,全天事件用 date 字段。常用参数包括 timeMin、timeMax、maxResults、orderBy、singleEvents、q、sendUpdates。创建/更新时可将 JSON 写入 /tmp/calendar_request.json 后用 curl 提交。
限制与注意:PATCH 更新 attendees 会替换整个数组,需包含全部目标参与者;修改重复事件全部实例需更新主事件,单次实例需更新对应实例 ID;应显式指定时区。连接排查可运行 zero doctor check-connector --env-name GOOGLE_CALENDAR_TOKEN 或 zero doctor check-connector --url https://www.googleapis.com/calendar/v3/users/me/calendarList --method GET。
其余如具体配额、收费与授权流程细节暂未提供。