跳至正文

连接器指南

为 AI Agent 连接 Google Sheets

通过统一 Action 接口操作电子表格。

由 OOMOL 维护·

源码核对日期：2026-09-09. 示例已按链接中的源码版本核对，不代表通过了真实上游 API 验证；你部署的版本可能有所不同。

认证方式

  • OAuth 2.0

打开本地控制台，选择服务并配置凭证。OAuth 服务需要你在对应平台上注册自己的 OAuth 应用。

凭证与 OAuth →

此连接器需要重点检查什么

此示例搜索 Google 连接可访问的电子表格。请同时检查声明的读取 scopes 和所选账号的文件权限。空列表不等于运行时执行失败。

调用前检查 Action

示例用途

搜索已连接 Google 账号有权访问的电子表格。

Action 所需权限范围

  • https://www.googleapis.com/auth/spreadsheets.readonly
  • https://www.googleapis.com/auth/drive.readonly

从运行中的实例读取 Schema，在执行前核对必填参数、权限和账号连接。

googlesheets.search_spreadsheets
curl -s http://localhost:3000/v1/actions/googlesheets.search_spreadsheets

连接账号后，根据自己的资源调整示例参数。如果 runtime 已启用认证，还需添加 runtime Bearer Token。

HTTP
curl -s -X POST \
  http://localhost:3000/v1/actions/googlesheets.search_spreadsheets \
  -H 'content-type: application/json' \
  -d '{"input":{"maxResults":5}}'

理解调用结果

HTTP 运行时响应包含 success、message、data 和 meta。请检查 success 及 Action 输出 Schema，不要只看 HTTP 状态码。执行元数据包含 executionId 时，可据此定位脱敏运行日志。下面仅展示响应结构，并非真实 API 调用结果。

示意响应
{
  "success": true,
  "message": "OK",
  "data": {},
  "meta": {}
}

调用失败时如何排查

  • 认证失败时，先核对接口和凭证类型：管理端凭证用于 /api，运行时 Bearer 令牌用于 /v1 和 /mcp。服务提供方的 API Key 不能替代运行时令牌。
  • 权限被拒绝时，检查 Action 所需 scopes、运行时 Action 规则和连接授权。令牌有效也不代表有权使用所选账号。
  • 结果为空或资源缺失时，检查连接账号及其对目标资源的访问权限。完成授权不代表能访问所有工作区、频道或文档。
  • 重试前先检查错误与运行日志。对于会修改服务数据的 Action，先确认操作是否已经完成，不要盲目重复请求。

能力验证

目录收录、本地执行器和上游 API 验证是不同状态。使用前请查看具体 Action 的源代码与验证说明。

源码核对日期：2026-09-09· 示例已按链接中的源码版本核对，不代表通过了真实上游 API 验证；你部署的版本可能有所不同。

查看源码↗阅读验证说明 →

下一步

对于支持的服务，OOMOL 负责 OAuth 应用配置与托管运行环境。账户选择与权限授权仍由你完成。

在 OOMOL 使用 ↗本地运行 →
探索连接器 →
阅读 Markdown