核心用法
Google Docs Skill 是 Maton 平台提供的托管式 OAuth 代理服务，将 Google Docs API 的原生能力封装为统一的 REST 接口。用户通过 MATON_API_KEY 认证后，可完成文档创建、内容插入、批量更新、样式格式化等操作。所有请求经由 https://api.maton.ai/google-docs/{native-api-path} 转发，Maton 自动注入 OAuth Token，无需开发者自行管理 Google 凭证。
典型工作流：
1. 配置环境变量 MATON_API_KEY
2. 创建或选择 Google OAuth 连接（POST /connections）
3. 浏览器完成授权后，使用 Maton-Connection 头指定连接
4. 调用标准 Docs API 端点（GET /documents/{id}、POST /documents、:batchUpdate 等）
关键操作支持：
- 文档创建与获取元数据
batchUpdate原子批量操作（插入文本、删除内容、替换占位符、插入表格/分页符、更新文本样式）- 1-based 索引定位，
endOfSegmentLocation支持尾部追加 - 字段掩码（field mask）精确控制样式更新范围
显著优点
| 优势 | 说明 |
|------|------|
| **零凭证管理** | OAuth 全生命周期由 Maton 托管，开发者不接触 Refresh Token |
| **原生 API 兼容** | 直接透传 Google Docs API，支持完整 batchUpdate 请求语义 |
| **多账户支持** | 通过 `Maton-Connection` 头灵活切换多个 Google 账户 |
| **原子操作** | batchUpdate 内多请求原子执行，避免部分成功状态 |
| **丰富示例** | 提供 Bash/Python/JavaScript 完整代码片段，降低接入门槛 |
潜在缺点与局限性
- 写入需显式授权：所有 create/update/delete 操作强制要求用户实时确认，自动化场景下增加交互摩擦
- 速率限制：10 req/sec/账户，高频批量场景需自行节流
- 索引复杂度：1-based 索引与动态文档结构耦合，需先
get文档解析结构才能安全更新 - 环境变量依赖：
MATON_API_KEY泄露即导致账户级风险，且 curl 管道场景存在变量展开失败陷阱（文档已特别提示） - 代理延迟：相较直连 Google，增加一跳网络转发，极端延迟敏感场景需评估
适合人群
- 需快速集成 Google Docs 且不愿自建 OAuth 体系的开发团队
- 多租户 SaaS 产品，需代表终端用户操作其 Google 文档
- 自动化报告生成、合同模板填充、协作内容同步等场景
常规风险
| 风险类别 | 描述 |
|----------|------|
| **密钥泄露** | `MATON_API_KEY` 拥有连接级访问权限，需按 Secret 级别保管 |
| **权限过度** | OAuth 连接默认请求 docs 作用域，用户应审查授权页权限清单 |
| **误操作破坏** | batchUpdate 原子性仅保证全部成功/失败，不防业务逻辑误删，写入前务必二次确认 |
| **供应商锁定** | 深度依赖 Maton 代理层，迁移需重建 OAuth 基础设施 |