核心功能
Google Forms Skill 是一个通过 Maton API Gateway 代理访问 Google Forms API 的工具，主要提供三类核心能力：
1. 表单生命周期管理
- 创建表单：支持创建空白表单并设置标题
- 批量更新：通过
batchUpdate接口添加/修改题目、调整表单结构 - 获取表单元数据：读取表单结构、问题配置等信息
2. 丰富的问题类型支持
| 类型 | 说明 |
|------|------|
| `textQuestion` | 短文本/段落文本输入 |
| `choiceQuestion` | 单选、多选、下拉菜单 |
| `scaleQuestion` | 线性量表评分（1-5/1-10等） |
| `dateQuestion` / `timeQuestion` | 日期/时间选择器 |
3. 响应数据获取
- 列出表单所有提交记录
- 获取单个响应详情
---
显著优点
托管 OAuth，零配置成本
开发者无需自行申请 Google Cloud 项目、配置 OAuth 客户端或处理 token 刷新。Maton 平台统一处理授权流程，通过 ctrl.maton.ai 管理连接状态。
原生 API 透传
路径设计为 gateway.maton.ai/google-forms/{native-api-path}，完全映射 Google 官方 REST API，文档成熟、行为可预期。
多连接管理
支持通过 Maton-Connection 头部切换不同 Google 账号，适合多租户场景或公私账号分离。
---
局限性与风险
供应商锁定于 Maton 平台
所有请求必须携带 Maton API Key，且 OAuth 授权链路完全依赖 Maton 的 connect.maton.ai 服务。若 Maton 服务中断或调整定价，迁移成本较高。
速率限制
文档明确标注 10 req/sec 的账户级限流，高频场景（如实时收集问卷并触发工作流）可能触顶。
数据隐私考量
表单响应数据流经 Maton 网关，虽文档未声明会持久化，但企业敏感调研场景需评估合规性。
错误透传的调试成本
4xx/5xx 错误直接透传 Google API 的原始响应，开发者需对照 Google 官方错误码表排查，网关层未做语义化封装。
---
适合人群
- 需快速原型验证、不愿投入 OAuth 配置成本的独立开发者
- 已在使用 Maton 生态、希望统一 API 密钥管理的团队
- 中小型自动化工作流（如 Zapier/Make 替代方案自建）
- 非敏感数据的常规问卷收集场景
---
常规风险提示
- Token 过期：OAuth 连接可能因用户撤销授权或长期未使用而失效，需设计连接状态检查与重授权流程
- 环境变量注入问题：文档特别提示
curl管道到jq时可能出现$MATON_API_KEY未展开的情况，建议显式传递变量 - URL 特殊字符：含方括号的 URL 需使用
curl -g禁用 glob 解析