核心用法
本 Skill 是 Google Forms API 的代理网关，采用托管 OAuth 2.0 模式（Maton 平台代为维护令牌刷新），用户仅需提供 MATON_API_KEY 即可调用完整 API。核心能力覆盖：
- 表单生命周期管理：创建表单（
POST /v1/forms）、批量更新（batchUpdate）、查询元数据（GET /v1/forms/{formId}）。 - 题型配置：支持文本题（含段落/短文本）、单选/多选/下拉（
choiceQuestion）、线性量表（scaleQuestion）、日期与时间选择器等。 - 响应数据获取：列出所有响应（
GET /v1/forms/{formId}/responses）或获取单条响应详情。 - 多连接管理：支持在
ctrl.maton.ai后台创建、查看、删除 Google OAuth 连接，并通过Maton-Connection请求头在多账号间切换。
技术接入上，请求路径需以 google-forms 为前缀（如 https://gateway.maton.ai/google-forms/v1/forms/...），Maton 网关负责将请求代理至 forms.googleapis.com 并注入有效 OAuth Token。
显著优点
1. 零 OAuth 维护成本：开发者无需处理 Google OAuth 2.0 的授权码交换、Token 刷新与存储，Maton 平台托管全生命周期。
2. 原生 API 透传：直接映射 Google 官方 REST API，支持所有高级特性（如 updateMask 细粒度更新、batchUpdate 原子批量操作）。
3. 多租户隔离：通过 Connection ID 区分不同 Google 账号，适合 SaaS 多客户场景或团队多账号管理。
4. 多语言示例完备：文档提供 Bash/curl、Python、JavaScript 等即拷即用代码片段，降低接入门槛。
5. 错误透明：HTTP 状态码与 Google 原生 API 保持一致（如 400 为连接缺失、401 为 API Key 无效、429 为限流），便于定位问题。
潜在缺点与局限性
1. 平台锁定风险：OAuth 授权与 Token 完全托管于 Maton，若平台服务中断或策略变更，可能导致授权失效；迁移需重新走 Google OAuth 流程。
2. 网络依赖与延迟：所有流量需经过 gateway.maton.ai 代理，相比直连 Google 增加一跳网络延迟，且受 Maton 网关稳定性制约。
3. 速率限制不透明：文档仅提及「10 req/sec per account」的粗略限流，未说明 Google 侧剩余配额（如每日 10000 请求）是否独立计算或共享。
4. 调试复杂度：OAuth 授权 URL 需人工在浏览器完成，自动化 CI/CD 场景难以无人值守；多连接场景下需手动指定 Maton-Connection 头，易遗漏。
5. Shell 环境陷阱：文档特别提示 curl 与 jq 管道时环境变量可能不展开，需改用 Python/Node 等脚本方式规避，增加脚本编写成本。
适合人群
- 快速原型开发者：需要在数小时内搭建问卷系统，不愿投入时间配置 Google Cloud 项目与 OAuth 凭据。
- 多账号运营团队：如市场部门管理多个品牌 Google 账号，需在同一系统内切换表单操作。
- 低代码/自动化工作流：配合 n8n、Make 或自研脚本，将表单创建与数据收集纳入自动化管道。
常规风险
| 风险类别 | 说明 |
|---------|------|
| **数据隐私合规** | 表单响应数据流经 Maton 网关，虽为透传代理，但需确认 Maton 隐私政策是否满足 GDPR、CCPA 等合规要求。 |
| **API Key 泄露** | `MATON_API_KEY` 作为唯一凭证，若硬编码于前端或日志中，可能导致账号被滥用；建议仅存储于服务端环境变量。 |
| **OAuth 权限粒度** | 授权时 Google 可能请求较宽范围权限（如访问全部表单），用户需确认是否接受，无法细粒度限定至单表单。 |
| **服务连续性** | 依赖 Maton 平台持续运营，建议定期备份关键表单 ID 与响应数据，防范供应商锁定。 |