SuperAPI AI 工具集

google_forms

通用与其它

查看项目

更新于 10-15 17:19

技能介绍

用途:通过 hatch_gws_cli 命令行工具管理用户的 Google 表单,可读取、创建、更新表单并读取回复。该命令行工具是唯一实现路径。

主要能力:表单状态查询与断开连接(hatch_gws_cli forms status / disconnect);表单获取、创建与批量更新(schema forms.forms.get / create / batchUpdate);回复列表与单条回复读取(schema forms.forms.responses.list / get)。回复读取保留 Google 原始时间戳,并补充语义化的 UTC 与用户本地时间。

使用方式:用 exec 运行 hatch_gws_cli forms <resource> <method> [flags]。首次使用先运行 hatch_gws_cli forms status;若状态为不可用,告知用户此设备不支持 Google 表单,不要提供替代集成方案或索要凭据。若为 not_connected 且返回 connect_url,将其替换为返回链接并以 Markdown 链接 Connect Google Forms 分享,等待用户重新连接。连接后可执行表单操作。调用不熟悉的方法前先用 schema 确认 --params 与 --json 的当前约定。

限制与规则:认证由包装器的 status 与 disconnect 子命令处理,不要手写凭据文件或运行原始 gws auth。创建表单以及编辑仅由用户拥有且未发布的表单可在明确请求下进行;编辑共享或已发布表单、或发布表单前需确认,因为内容可能触达他人。展示回复数据前先运行 forms.get,以便将问题 ID 映射为可读结构。表单 ID 与回复 ID 视为不透明字符串,仅使用先前命令返回或用户明确提供的 ID。断开连接后若有 disconnect_url,以 Markdown 链接 Disconnect Google Forms 分享。请求全部回复时需翻页,nextPageToken 缺失即停止。读写后只向用户确认可见结果,除非用户要求或排查故障,不展示原始 API 标识符或内部字段。