核心用法
Google Calendar Skill 是 Maton 平台提供的官方代理服务，允许用户以 RESTful API 形式调用完整的 Google Calendar API，无需自行处理 OAuth 2.0 授权流程。用户只需持有 Maton API Key，即可通过 gateway.maton.ai 网关代理访问 Google 的原生接口。
典型使用流程：
1. 在 Maton 控制台创建 Google Calendar OAuth 连接
2. 获取连接 URL 完成 Google 账号授权
3. 使用 Maton API Key 调用网关，自动注入 OAuth Token
支持的核心操作包括：列出日历/事件、创建/更新/删除事件（支持全天事件与重复事件展开）、Quick Add 自然语言创建、Free/Busy 空闲查询等。多连接场景可通过 Maton-Connection 头部指定。
显著优点
- 零 OAuth 维护成本：Maton 托管 token 刷新与生命周期管理，开发者无需实现授权服务器
- 原生 API 透传：完全保留 Google Calendar API 的接口语义，无学习成本迁移
- 多语言友好：提供 JavaScript/Python 示例，标准 HTTP 调用适配任意技术栈
- 多账号支持：通过 Connection ID 隔离不同 Google 账号，适合团队多租户场景
潜在缺点与局限性
- 供应商锁定：依赖 Maton 网关的可用性，若服务中断则无法直连 Google
- 速率限制：10 req/sec 的硬性限制，高频场景需本地缓存或降级策略
- 数据隐私：日历数据流经 Maton 网关，敏感场景需评估第三方代理合规性
- 成本不透明：文档未提及定价，生产使用需确认 Maton 平台的计费模式
适合人群
- 快速原型开发，希望跳过 OAuth 实现成本的独立开发者
- 需要整合多用户 Google 日历的 SaaS 工具（如会议调度、CRM 系统）
- 内部自动化脚本，需无人值守操作团队日历的管理员
常规风险
- 连接过期：OAuth refresh 可能因用户撤销授权而失效，需处理 400 错误并引导重新授权
- Token 泄露：Maton API Key 等同于账户权限，需按密钥管理最佳实践存储（环境变量、密钥管理系统）
- Google API 变更：上游接口字段变更可能破坏现有集成，建议锁定
calendar/v3版本并关注 Google 官方公告