核心用法
本 skill 通过 Maton 网关代理调用 Google Docs REST API，开发者仅需提供 Maton API Key 即可完成 OAuth 认证与文档操作。核心功能包括：获取/创建文档、批量更新（插入文本、删除内容、替换占位符、插入表格、更新样式等）、多连接管理。
典型工作流：
1. 在 ctrl.maton.ai 创建 Google Docs OAuth 连接
2. 通过 gateway.maton.ai/google-docs/v1/... 代理端点发起请求
3. 使用 batchUpdate 执行原子化批量操作
显著优点
- 托管 OAuth：无需自行处理 Google 开发者控制台配置、刷新令牌存储与轮换
- 原生 API 透传：支持完整的 Google Docs API 语义，包括复杂的
endOfSegmentLocation、field masks等特性 - 多连接支持：可通过
Maton-Connection头指定不同 Google 账号，适合多租户场景 - 跨语言兼容：纯 HTTP 接口，附赠 Python/JavaScript/curl 示例代码
潜在缺点与局限性
- 网关依赖：所有请求必须经过 Maton 基础设施，存在单点故障风险
- 速率限制：10 req/sec 的账户级限流对高频批量操作可能不足
- 成本不透明：未提及 Maton 服务的定价模型与免费额度
- 延迟增加：相比直连 Google API，增加了代理跳转开销
- 功能边界：仅覆盖 Docs API，不涉及 Google Drive 文件权限管理、Sheets 或 Slides
适合人群
- 希望快速集成 Google Docs 自动化、不愿投入 OAuth 基础设施建设的中小团队
- 需要在多 Google 账号间切换的数据迁移或报告生成场景
- 使用 Python/JavaScript 构建文档工作流的独立开发者
常规风险
| 风险类型 | 说明 |
|---------|------|
| 供应商锁定 | 深度依赖 Maton 的网关与连接管理服务 |
| 密钥泄露 | `MATON_API_KEY` 泄露将导致所有连接文档的未授权访问 |
| OAuth 范围 | 默认连接可能请求宽泛的 Google 账户权限，需审查授权页面 |
| 数据隐私 | 文档内容流经第三方网关，存在潜在中间人审查风险 |