核心用法
Google Calendar Skill 是 Maton 平台提供的官方 Google Calendar API 代理服务，采用托管式 OAuth 2.0 认证方案。用户通过 MATON_API_KEY 环境变量进行身份验证，无需自行处理复杂的 Google OAuth 流程。该 Skill 将请求代理至 www.googleapis.com，自动注入用户的 OAuth Token，支持完整的日历 CRUD 操作。
主要功能包括：
- 日历管理：列出日历列表、获取日历详情
- 事件操作：创建/读取/更新/删除事件，支持全天事件和快速添加（自然语言解析）
- 可用性查询：Free/Busy 时段查询，便于会议安排
- 多账户支持：通过
Maton-Connection头部指定不同 Google 账号
显著优点
1. 零配置 OAuth：Maton 托管完整的 OAuth 生命周期，用户仅需完成一次性网页授权
2. 原生 API 兼容：直接暴露 Google Calendar API v3 接口，文档成熟、功能完整
3. 多语言示例：提供 Python、JavaScript、cURL 等完整代码片段，降低接入门槛
4. 连接管理灵活：支持多账号切换、连接状态查询和主动删除
潜在缺点与局限性
- 平台依赖：重度绑定 Maton 生态，迁移成本较高；若 Maton 服务中断，功能不可用
- 速率限制：10 req/sec 的硬限制，高并发场景需自行实现队列或缓存
- 网络要求：必须保持外网连接，无法离线使用
- 数据隐私：日程数据流经 Maton 代理层，存在额外的信任假设
适合人群
- 需要快速集成 Google Calendar 的独立开发者或小团队
- 不想维护 OAuth 基础设施的 SaaS 产品后端
- 构建会议助手、日程提醒、自动化工作流等 AI Agent 场景
常规风险
1. Token 泄露：MATON_API_KEY 一旦泄露，攻击者可访问用户全部日历数据；建议配合密钥管理服务使用
2. 误操作风险：文档明确要求写操作前需用户二次确认，但实际依赖调用方实现
3. OAuth 会话过期：长期运行任务需处理 Token 刷新逻辑，Maton 托管层应处理但仍需关注连接状态
4. API 变更：Google Calendar API 版本迭代可能导致接口变动，需关注官方变更日志