Google Forms 是 Google 的在线调查和表单工具，允许用户创建表单、收集回复并分析结果。作为 Google 办公套件的一部分，Google Forms 使用户能够轻松收集信息、反馈和数据。
了解如何在 Aptlystar 中集成 Google Forms 工具，以自动读取和处理表单回复。本教程将指导您连接 Google Forms、检索回复，并使用收集到的数据来驱动自动化。非常适合实时同步调查结果、注册信息或反馈给您的代理。
使用 Google Forms，您可以：
- 创建调查和表单：设计用于反馈、注册、测验等的自定义表单
- 自动收集回复：实时收集用户数据
- 分析结果：在 Google Forms 中查看回复或导出到 Google Sheets 进行进一步分析
- 轻松协作：共享表单，与他人一起构建和审查问题
- 与其他 Google 服务集成：连接 Google Sheets、Drive 等
在 Aptlystar 中，Google Forms 集成使您的代理可以以编程方式访问表单响应。这为强大的自动化场景提供了可能，例如处理调查数据、根据新提交触发工作流以及将表单结果与其他工具同步。您的代理可以获取表单的所有响应、检索特定响应，并使用这些数据推动智能自动化。通过将 Aptlystar 与 Google Forms 连接，您可以实现数据收集自动化、简化反馈处理，并将表单响应整合到代理的功能中。
将 Google Forms 集成到您的工作流中。提供表单 ID 以列出响应，或指定响应 ID 以获取单个响应。需要 OAuth。
| 参数 | 类型 | 必需 | 描述 |
|---|
| formId | string | 是 | Google 表单的 ID |
| responseId | string | 否 | 如果提供，将返回此特定响应 |
| pageSize | number | 否 | 要返回的最大响应数（服务可能返回更少）。默认为 5000 |
检索表单结构，包括其项目、设置和元数据
| 参数 | 类型 | 必需 | 描述 |
|---|
formId | string | 是 | 要检索的 Google 表单 ID |
| 参数 | 类型 | 描述 |
|---|
formId | string | 表单 ID |
title | string | 响应者可见的表单标题 |
description | string | 表单描述 |
documentTitle | string | 在 Drive 中可见的文档标题 |
responderUri | string | 可与响应者分享的 URI |
linkedSheetId | string | 关联 Google 表格的 ID |
revisionId | string | 表单的修订 ID |
items | array | 表单项目（问题、分节等） |
↳ itemId | string | 项目 ID |
↳ title | string | 项目标题 |
↳ description | string | 项目描述 |
settings | json | 表单设置 |
publishSettings | json | 表单发布设置 |
创建一个带有标题的新 Google 表单
| 参数 | 类型 | 必需 | 描述 |
|---|
title | string | 是 | 响应者可见的表单标题 |
documentTitle | string | 否 | 在 Drive 中可见的文档标题（默认为表单标题） |
unpublished | boolean | 否 | 如果为 true，则创建一个不接受响应的未发布表单 |
| 参数 | 类型 | 描述 |
|---|
formId | string | 创建的表单 ID |
title | string | 表单标题 |
documentTitle | string | Drive 中的文档标题 |
responderUri | string | 可与答题者分享的 URI |
revisionId | string | 表单的修订版本 ID |
对表单应用多项更新（添加项目、更新信息、更改设置等）
| 参数 | 类型 | 必需 | 描述 |
|---|
formId | string | 是 | Google Forms 表单 ID |
requests | json | 是 | 更新请求数组（updateFormInfo、updateSettings、createItem、updateItem、moveItem、deleteItem） |
includeFormInResponse | boolean | 否 | 是否在响应中返回已更新的表单 |
| 参数 | 类型 | 描述 |
|---|
replies | array | 每个更新请求的回复 |
writeControl | object | 包含修订版本 ID 的写入控制信息 |
↳ requiredRevisionId | string | 用于冲突检测的必需修订版本 ID |
↳ targetRevisionId | string | 目标修订版本 ID |
form | object | 已更新的表单（如果 includeFormInResponse 为 true） |
↳ formId | string | 表单 ID |
↳ info | object | 包含标题和描述的表单信息 |
↳ title | string | 答题者可见的表单标题 |
↳ description | string | 表单描述 |
↳ documentTitle | string | Drive 中可见的文档标题 |
↳ settings | object | 表单设置 |
↳ quizSettings | object | 测验设置 |
↳ isQuiz | boolean | 是否为测验表单 |
↳ emailCollectionType | string | 邮箱收集类型 |
↳ revisionId | string | 表单的修订版本 ID |
↳ responderUri | string | 可与答题者分享的 URI |
↳ linkedSheetId | string | 关联的 Google 表格 ID |
↳ publishSettings | object | 表单发布设置 |
↳ publishState | object | 当前发布状态 |
↳ isPublished | boolean | 表单是否已发布 |
↳ isAcceptingResponses | boolean | 表单是否接受响应 |
更新表单的发布设置（发布/取消发布，接受响应）
| 参数 | 类型 | 必需 | 描述 |
|---|
formId | string | 是 | Google Forms 表单 ID |
isPublished | boolean | 是 | 表单是否已发布并对他人可见 |
isAcceptingResponses | boolean | 否 | 表单是否接受响应（如果 isPublished 为 false，则强制为 false） |
| 参数 | 类型 | 描述 |
|---|
formId | string | 表单 ID |
publishSettings | json | 更新后的发布设置 |
↳ publishState | object | 发布状态 |
↳ isPublished | boolean | 表单是否已发布 |
↳ isAcceptingResponses | boolean | 表单是否接受响应 |
为表单变更（结构变更或新响应）创建通知监听
| 参数 | 类型 | 必需 | 描述 |
|---|
formId | string | 是 | 要监听的 Google Forms 表单 ID |
eventType | string | 是 | 要监听的事件类型：SCHEMA（表单结构变更）或 RESPONSES（新提交） |
topicName | string | 是 | Cloud Pub/Sub 主题名称（格式：projects/{project}/topics/{topic}） |
watchId | string | 否 | 自定义监听 ID（4-63 个字符，小写字母、数字、连字符） |
| 参数 | 类型 | 描述 |
|---|
id | string | 监视 ID |
eventType | string | 被监视的事件类型 |
topicName | string | Cloud Pub/Sub 主题 |
createTime | string | 监视创建时间 |
expireTime | string | 监视过期时间（创建后 7 天） |
state | string | 监视状态（ACTIVE，SUSPENDED） |
列出表单的所有通知监视
| 参数 | 类型 | 必需 | 描述 |
|---|
formId | string | 是 | Google Forms 表单 ID |
| 参数 | 类型 | 描述 |
|---|
watches | array | 表单的监视列表 |
↳ id | string | 监视 ID |
↳ eventType | string | 事件类型（SCHEMA 或 RESPONSES） |
↳ createTime | string | 监视创建时间 |
↳ expireTime | string | 监视过期时间 |
↳ state | string | 监视状态 |
从表单中删除通知监视
| 参数 | 类型 | 必需 | 描述 |
|---|
formId | string | 是 | Google Forms 表单 ID |
watchId | string | 是 | 要删除的监视 ID |
| 参数 | 类型 | 描述 |
|---|
deleted | boolean | 是否成功删除了监视 |
将通知监视续订 7 天
| 参数 | 类型 | 必需 | 描述 |
|---|
formId | string | 是 | Google Forms 表单 ID |
watchId | string | 是 | 要续订的监视 ID |
| 参数 | 类型 | 描述 |
|---|
id | string | 监视 ID |
eventType | string | 被监视的事件类型 |
expireTime | string | 新的过期时间 |
state | string | 监视状态 |
