核心用法
Google Drive skill 是 Maton 平台提供的托管式 Google Drive API 代理服务，允许开发者通过统一的 REST 接口访问完整的 Google Drive 功能。用户无需自行处理复杂的 OAuth 2.0 流程，Maton 自动管理令牌注入和刷新。
认证与连接
- 使用
MATON_API_KEY作为统一凭证 - 通过 Maton 连接中心创建 Google OAuth 连接
- 支持多账户管理，通过
Maton-Connection头部指定目标账户
主要功能覆盖
- 文件操作：列出、搜索、获取元数据、下载、导出（支持 PDF 等格式）
- 目录管理：创建文件夹、移动文件、管理父子关系
- 内容上传：三种上传模式——简单上传（<5MB）、多部分上传（<5MB 含元数据）、可恢复上传（>5MB，支持断点续传）
- 权限控制：文件分享、权限添加与管理
- 高级查询：支持 Drive API 完整的搜索语法（name contains、mimeType 过滤、时间范围等）
技术特性
- 原生兼容 Google Drive API v3 路径
- 自动处理 OAuth token 注入
- 支持 5TB 大文件上传（通过分片机制）
- 完整的错误码透传和速率限制管理（10 req/sec）
显著优点
1. 零 OAuth 维护成本：开发者无需实现授权流程、令牌存储和刷新逻辑
2. 多语言友好：提供 Python、JavaScript、Bash/curl 完整示例
3. 企业级上传支持：可恢复上传（Resumable Upload）确保大文件传输可靠性
4. 细粒度字段控制：通过 fields 参数减少响应体积，优化性能
潜在缺点与局限性
1. 速率限制：10 req/sec 的硬性限制，高并发场景需客户端缓存或队列
2. 单点依赖：Maton 服务可用性直接影响功能，非原生 Google 直连
3. 元数据覆盖：更新文件内容时需显式指定 uploadType，与原生 API 行为略有差异
4. 实时性延迟：OAuth 状态变更可能存在同步延迟
适合人群
- 需要快速集成 Google Drive 的 SaaS 开发者
- 自动化文档工作流（报告生成、备份、归档）的 DevOps 工程师
- 不愿维护 OAuth 基础设施的小型团队
- 需要跨多 Google 账户管理文件的企业用户
常规风险
- 数据主权：文件内容流经 Maton 代理服务器，需信任第三方数据处理器
- 权限扩散：
All write operations require explicit user approval的提示表明写操作风险较高，误操作可能导致数据丢失 - 令牌安全：
MATON_API_KEY泄露将导致连接的 Google 账户被完全访问 - 合规边界：涉及敏感文档时需确认 Maton 的数据处理协议是否符合 GDPR/CCPA 等法规