opensource/sim
3
0
Fork 0
mirror of https://github.com/simstudioai/sim.git synced 2026-09-24 15:45:35 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
40a3962c1e277d585c36314a7732885eef84758c
sim/apps/docs/content/docs/zh/tools/google_forms.mdx
T
Waleedandcherkanov_art 40a3962c1e fix(docs): update docs and disable i18n action, upgrade turborepo (#3227) 
* feat(i18n): change lockfile (#3216)

* fix: update i18n.lock

* feat(docs): enhance documentation with new sections on file handling, form deployment, quick reference, agent skills, and A2A integration

* fix(docs): update docs and disable i18n action

* fix build

---------

Co-authored-by: cherkanov_art <45258907+cherkanovart@users.noreply.github.com>
2026-02-16 00:20:25 -08:00

245 lines
9.1 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
title: Google Forms
description: 查看 Google 表单的回复
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard
type="google_forms"
color="#E0E0E0"
/>
{/* MANUAL-CONTENT-START:intro */}
[Google Forms](https://forms.google.com) 是 Google 的在线调查和表单工具，允许用户创建表单、收集回复并分析结果。作为 Google 办公套件的一部分，Google Forms 使用户能够轻松收集信息、反馈和数据。
了解如何在 Sim 中集成 Google Forms 工具，以自动读取和处理表单回复。本教程将指导您连接 Google Forms、检索回复，并使用收集到的数据来驱动自动化。非常适合实时同步调查结果、注册信息或反馈给您的代理。
使用 Google Forms，您可以：
- **创建调查和表单**：设计用于反馈、注册、测验等的自定义表单
- **自动收集回复**：实时收集用户数据
- **分析结果**：在 Google Forms 中查看回复或导出到 Google Sheets 进行进一步分析
- **轻松协作**：共享表单，与他人一起构建和审查问题
- **与其他 Google 服务集成**：连接 Google Sheets、Drive 等
在 Sim 中，Google Forms 集成使您的代理可以以编程方式访问表单响应。这为强大的自动化场景提供了可能，例如处理调查数据、根据新提交触发工作流以及将表单结果与其他工具同步。您的代理可以获取表单的所有响应、检索特定响应，并使用这些数据推动智能自动化。通过将 Sim 与 Google Forms 连接，您可以实现数据收集自动化、简化反馈处理，并将表单响应整合到代理的功能中。
{/* MANUAL-CONTENT-END */}
## 使用说明
将 Google Forms 集成到您的工作流中。提供表单 ID 以列出响应，或指定响应 ID 以获取单个响应。需要 OAuth。
## 工具
### `google_forms_get_responses`
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| formId | string | 是 | Google 表单的 ID |
| responseId | string | 否 | 如果提供，将返回此特定响应 |
| pageSize | number | 否 | 要返回的最大响应数（服务可能返回更少）。默认为 5000 |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `data` | json | 响应或响应列表 |
## 注意事项
- 类别：`tools`
- 类型：`google_forms`
检索表单结构，包括其项目、设置和元数据
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `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_forms_create_form`
创建一个带有标题的新 Google 表单
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `title` | string | 是 | 响应者可见的表单标题 |
| `documentTitle` | string | 否 | 在 Drive 中可见的文档标题（默认为表单标题） |
| `unpublished` | boolean | 否 | 如果为 true，则创建一个不接受响应的未发布表单 |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `formId` | string | 创建的表单 ID |
| `title` | string | 表单标题 |
| `documentTitle` | string | Drive 中的文档标题 |
| `responderUri` | string | 可与答题者分享的 URI |
| `revisionId` | string | 表单的修订版本 ID |
### `google_forms_batch_update`
对表单应用多项更新（添加项目、更新信息、更改设置等）
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `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 | 表单是否接受响应 |
### `google_forms_set_publish_settings`
更新表单的发布设置（发布/取消发布，接受响应）
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `formId` | string | 是 | Google Forms 表单 ID |
| `isPublished` | boolean | 是 | 表单是否已发布并对他人可见 |
| `isAcceptingResponses` | boolean | 否 | 表单是否接受响应（如果 isPublished 为 false，则强制为 false） |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `formId` | string | 表单 ID |
| `publishSettings` | json | 更新后的发布设置 |
| ↳ `publishState` | object | 发布状态 |
| ↳ `isPublished` | boolean | 表单是否已发布 |
| ↳ `isAcceptingResponses` | boolean | 表单是否接受响应 |
### `google_forms_create_watch`
为表单变更（结构变更或新响应）创建通知监听
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `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） |
### `google_forms_list_watches`
列出表单的所有通知监视
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `formId` | string | 是 | Google Forms 表单 ID |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `watches` | array | 表单的监视列表 |
| ↳ `id` | string | 监视 ID |
| ↳ `eventType` | string | 事件类型（SCHEMA 或 RESPONSES） |
| ↳ `createTime` | string | 监视创建时间 |
| ↳ `expireTime` | string | 监视过期时间 |
| ↳ `state` | string | 监视状态 |
### `google_forms_delete_watch`
从表单中删除通知监视
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `formId` | string | 是 | Google Forms 表单 ID |
| `watchId` | string | 是 | 要删除的监视 ID |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `deleted` | boolean | 是否成功删除了监视 |
### `google_forms_renew_watch`
将通知监视续订 7 天
#### 输入
| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `formId` | string | 是 | Google Forms 表单 ID |
| `watchId` | string | 是 | 要续订的监视 ID |
#### 输出
| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `id` | string | 监视 ID |
| `eventType` | string | 被监视的事件类型 |
| `expireTime` | string | 新的过期时间 |
| `state` | string | 监视状态 |
Reference in New Issue View Git Blame Copy Permalink