核心用法
本Skill为纯文档型API集成指南，无实际可执行代码，通过Maton API网关代理调用Google Forms原生API。用户需：
1. 获取API密钥：注册maton.ai账户并设置MATON_API_KEY环境变量
2. 建立OAuth连接：通过ctrl.maton.ai完成Google账号授权
3. 调用网关API：使用标准HTTP方法操作表单（创建/查询/更新/获取响应）
核心端点包括：
GET /google-forms/v1/forms/{formId} — 获取表单元数据POST /google-forms/v1/forms — 创建新表单POST /google-forms/v1/forms/{formId}:batchUpdate — 批量添加题目GET /google-forms/v1/forms/{formId}/responses — 获取提交响应
支持题型涵盖文本、单选/多选/下拉、量表评分、日期时间等。
---
显著优点
| 优势 | 说明 |
|------|------|
| **零本地依赖** | 纯Markdown文档，无package.json/requirements.txt，供应链攻击面为零 |
| **托管OAuth简化** | Maton处理令牌刷新与存储，用户无需实现OAuth 2.0完整流程 |
| **原生API完整能力** | 直接透传Google Forms API，功能与官方一致 |
| **多连接管理** | 支持`Maton-Connection`头指定不同Google账号，适合团队协作场景 |
| **跨语言示例** | 提供JavaScript/Python代码片段，降低接入门槛 |
---
潜在缺点与局限性
- 外部服务依赖：完全依赖Maton网关可用性，若服务中断则Skill失效
- 速率限制严格：10 req/sec账户级限流，大规模数据导出需分页控制
- 无离线能力：必须联网，无法本地缓存或批量预处理
- 隐私合规转嫁：表单数据流经Maton网关，需信任其数据处理政策（虽报告评估为可信）
- 功能边界：仅支持读/写表单结构与响应，不支持高级功能如条件逻辑设置、样式主题修改
---
适合人群
- 开发者/自动化工程师：需将表单数据集成至内部系统的技术用户
- 数据分析团队：批量导出Google Forms响应进行离线分析
- SaaS集成场景：通过Maton网关统一纳管多个Google Workspace应用连接
- 低代码自动化：结合n8n/Zapier等工具调用Maton API实现问卷自动化
---
常规风险
| 风险类别 | 具体描述 | 缓释建议 |
|----------|----------|----------|
| **密钥泄露** | `MATON_API_KEY`若硬编码或提交至版本控制，可导致账户被滥用 | 严格使用环境变量，启用密钥轮换 |
| **连接越权** | 多用户场景下未指定`Maton-Connection`头可能误用默认连接 | 显式声明连接ID，定期审计活跃连接 |
| **数据残留** | 删除Maton连接后，Google端表单数据仍存在，需分别清理 | 建立数据生命周期管理SOP |
| **OAuth范围过度** | Google授权时可能请求超出实际需要的Scopes | 审查Maton申请的权限范围，最小化授权 |
| **供应商锁定** | 深度依赖Maton网关后迁移至直接Google API需重构认证层 | 抽象API调用层，保留切换能力 |