核心用法
本技能提供对 Google Forms API 的托管式 OAuth 代理访问，允许开发者通过 Maton 平台创建表单、添加各类问题（文本、多选、量表等）以及检索用户响应。核心工作流为：1) 在 maton.ai 获取 API 密钥并设置环境变量 MATON_API_KEY；2) 通过 Connections API 创建并激活 Google OAuth 连接；3) 使用标准 REST 方法调用 https://api.maton.ai/google-forms/{native-api-path}，Maton 自动注入 OAuth Token。
支持的操作包括：获取/创建表单、批量更新（batchUpdate）表单结构、列出/获取单个响应。问题类型涵盖短文本、段落、单选/多选/下拉、线性量表、日期和时间选择器。提供 Python urllib、requests 及 JavaScript fetch 的完整代码示例。
显著优点
- 零 OAuth 基础设施：Maton 完全托管 OAuth 流程，开发者无需处理 Token 刷新、密钥存储或授权服务器搭建。
- 原生 API 兼容性：直接透传 Google Forms REST API 请求路径和响应格式，降低学习成本，官方文档可直接套用。
- 多连接管理：支持通过
Maton-Connection头部切换多个 Google 账号，适合多租户或团队场景。 - 跨语言示例：提供 Bash/Python/JavaScript 可运行代码片段，快速启动开发。
潜在缺点与局限性
- 第三方代理依赖：所有流量经过 Maton 服务器（api.maton.ai），存在单点故障和供应商锁定风险；若 Maton 服务中断或策略变更，将直接影响业务。
- 速率限制：明确标注 10 req/sec 每账号的硬限制，高并发场景需自行实现退避重试。
- 环境变量敏感：
MATON_API_KEY作为唯一认证凭证，泄露即意味着账户完全失控；文档未提及密钥轮换或最小权限细分机制。 - 功能透传限制：仅支持 Google Forms 原生 API 已有的能力，无法扩展高级逻辑（如条件跳转的复杂编排、实时 Webhook 通知）。
- 地域与合规盲区：文档未说明数据是否跨境传输、是否通过 SOC2/ISO27001 审计，企业级合规场景需额外尽调。
适合人群
- 需要快速集成 Google Forms 但不愿维护 OAuth 代码的中小开发者
- 内部工具/自动化脚本编写者（如用 Python 批量生成调研问卷）
- 低代码/无代码平台希望扩展表单能力的集成商
常规风险
- 密钥泄露风险：
MATON_API_KEY在命令行示例中以环境变量形式出现，易通过历史记录、日志或 CI/CD 配置泄露；建议配合密钥管理服务（如 AWS Secrets Manager）使用。 - 误操作风险：批量更新（batchUpdate）可直接修改生产表单结构，文档虽提示写操作需用户确认，但自动化脚本中仍可能因索引错误导致数据丢失。
- OAuth 范围泛化：连接一旦建立，技能默认获得对账户内所有表单的读写权限，无法按表单粒度限制范围，最小权限原则落实不足。