Google Calendar

核心用法

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 官方公告

核心用法

Google Calendar Skill 是一个纯文档型 API 集成工具，通过 Maton 托管的 OAuth 网关代理访问 Google Calendar API。用户无需直接处理 Google OAuth 流程，仅需 Maton API Key 即可调用完整日历功能。

主要功能模块：

• 连接管理：通过 ctrl.maton.ai 创建、查看、删除 Google OAuth 连接
• 日历操作：列出日历、获取日历详情
• 事件管理：创建/更新/删除事件、支持自然语言快速添加（Quick Add）
• 查询功能：列出事件、空闲/忙碌查询（Free/Busy）
• 多语言示例：提供 JavaScript 和 Python 完整代码示例

调用方式：所有请求通过 https://gateway.maton.ai/google-calendar/{native-api-path} 代理，自动注入 OAuth Token，支持 Maton-Connection 头部指定多连接场景。

显著优点

1. 零代码安全架构：纯 Markdown 文档，无可执行代码，彻底消除代码注入、依赖漏洞等传统风险
2. 托管 OAuth 简化：屏蔽复杂的 Google OAuth 2.0 流程，降低开发者集成门槛
3. 原生 API 透传：完整保留 Google Calendar API 语义，支持所有官方端点参数
4. 多连接支持：通过 Connection ID 管理多个 Google 账号，适合团队协作场景
5. T2 可信来源：Maton 为可信组织/GitHub 组织账号，MIT 开源协议透明

潜在缺点与局限性

1. 网络依赖性强：必须保持与 Maton 网关 (gateway.maton.ai) 的实时连接，无法离线使用
2. 速率限制：10 req/sec 每账户的硬限制，高并发场景需额外设计
3. 服务商锁定：OAuth Token 和连接状态由 Maton 托管，迁移成本较高
4. 功能边界：仅为 API 代理层，不提供日历 UI 组件或高级调度算法
5. 错误透传风险：Google API 的 4xx/5xx 错误直接透传，错误处理需调用方实现

适合人群

• 需要快速集成 Google Calendar 的 SaaS 开发者
• 不愿维护 OAuth 基础设施的小团队
• 多 Google Workspace 账号管理的企业 IT 管理员
• AI Agent 和自动化工作流构建者（需日历数据输入/输出）

常规风险

• 连接失效风险：Google OAuth Token 过期或用户撤销授权时返回 400，需重新授权
• 数据隐私：日历事件数据流经 Maton 网关，需信任 Maton 的数据处理声明
• 服务商可用性：Maton 服务中断将导致完全不可用
• API 变更同步：Google Calendar API 变更后，文档可能滞后更新