核心用法
本技能提供对 Google Forms API 的代理访问，通过 Maton 网关实现托管式 OAuth 认证。用户无需自行处理 Google OAuth 流程，仅需 Maton API Key 即可调用完整的 Forms API 能力，包括创建表单、批量添加题目（文本、单选、量表、日期等类型）、获取表单元数据及拉取用户填答记录。
主要操作流程：1）在 ctrl.maton.ai 创建 Google Forms 连接并完成授权；2）使用 Authorization: Bearer $MATON_API_KEY 调用 gateway.maton.ai/google-forms/{native-api-path}；3）通过标准 REST 方法（GET/POST）操作表单资源。
显著优点
- 零 OAuth 运维成本：Maton 集中托管 Google 令牌刷新与权限管理，开发者只需关心业务逻辑。
- 原生 API 透传：路径与请求体直接映射 Google 官方 API，学习成本低，可复用 Google 官方文档。
- 多连接管理：支持多 Google 账号连接，通过
Maton-Connection头部灵活切换。 - 多语言示例：提供 Python、JavaScript、Bash 完整代码片段，降低接入门槛。
潜在缺点与局限性
- 中间商依赖：所有流量经 Maton 网关转发，存在单点故障与服务连续性风险；若 Maton 服务中断，API 调用将失效。
- 速率限制：账户级限流 10 req/sec，大规模数据采集场景需自行实现错峰或批量拉取策略。
- 数据隐私：表单内容与用户填答数据流经第三方网关，对敏感信息（PII、医疗、金融数据）存在合规隐患。
- 功能边界：仅覆盖 Google Forms API 已有能力，不支持高级功能如条件逻辑分支、第三方插件集成等扩展。
适合人群
- 需要快速原型验证或内部工具集成的开发者/产品经理；
- 缺乏 Google Cloud 运维资源、希望跳过 OAuth 配置的小型团队；
- 自动化工作流构建者（如基于填答触发后续处理）。
常规风险
- 凭证泄露：
MATON_API_KEY一旦泄露，攻击者可访问该账号下所有 Google Forms 连接；需严格管控环境变量与 CI/CD 密钥管理。 - 授权范围过度：OAuth 授权时 Google 可能请求较宽的数据访问权限，用户应审查授权页面，避免不必要的范围授予。
- 连接过期：长期未使用的连接可能进入失效状态，生产系统需监控
status并设计重授权提醒机制。 - 数据滞留：网关层面可能临时缓存请求/响应，涉及 GDPR、CCPA 等合规场景需与 Maton 确认数据处理协议（DPA）。