Google Sheet Input Node

Google Sheet Input Node 用于从 Google Sheets 读取数据，是数据输入类节点。节点自动处理数据读取和格式转换，将表格数据传递给下游节点进行处理。

---

节点信息

属性	值
节点类型	gsheet_input_node
显示名称	Google Sheet Input
节点分类	Input（数据输入）
图标	📊 Sheet 图标（紫色）
句柄颜色	Emerald（绿色）

---

功能说明

Google Sheet Input Node 从 Google Sheets 读取数据，并将数据转换为标准 JSON 格式供下游节点使用。

主要用途：

• 从 Google Sheets 读取数据

• 导入历史数据用于分析

• 加载配置数据

• 读取交易记录

• 获取外部数据集

核心特性：

• 📊 Google Sheets 集成：直接读取 Google Sheets 数据

• 🔄 自动格式化：将表格数据转换为 JSON 格式

• 📋 表头支持：自动识别和处理表头行

• 🔗 URL 支持：支持完整 URL 或 Sheet ID

---

输入参数

参数列表

参数	类型	必填	默认值	说明
doc_link	text	❌	-	Google Sheets URL 或 ID

doc_link 参数

支持的格式：

1. 完整 URL：

https://docs.google.com/spreadsheets/d/1uQvzsNIkaan67wFijnDiixusw9qNZnedW4Q3dWJASBM/edit?usp=sharing

1. Sheet ID：

1uQvzsNIkaan67wFijnDiixusw9qNZnedW4Q3dWJASBM

1. 简化 URL：

docs.google.com/spreadsheets/d/1uQvzsNIkaan67wFijnDiixusw9qNZnedW4Q3dWJASBM

ID 提取：

• 节点自动从 URL 中提取 Sheet ID

• 无需手动复制 ID

---

输出参数

输出列表

输出 ID	显示名称	数据类型	说明
data	Data	object	读取的数据

data 输出

数据类型： object

数据结构：

{
  headers: string[];     // 列名数组
  rows: Array<any[]>;    // 数据行数组
  row_count: number;     // 数据行数
  column_count: number;  // 列数
}

示例输出：

{
  "headers": ["Date", "Symbol", "Price", "Volume"],
  "rows": [
    ["2024-01-15", "BTC", "45000", "1000"],
    ["2024-01-16", "ETH", "2500", "5000"],
    ["2024-01-17", "APT", "10", "10000"]
  ],
  "row_count": 3,
  "column_count": 4
}

---

使用示例

示例 1：读取价格数据

场景： 从 Google Sheets 读取历史价格数据进行分析。

Google Sheets 内容：

| Date       | Symbol | Price | Volume |
|------------|--------|-------|--------|
| 2024-01-15 | BTC    | 45000 | 1000   |
| 2024-01-16 | ETH    | 2500  | 5000   |

工作流结构：

Google Sheet Input Node (读取价格数据)
    ↓ data
Code Node (计算均价和趋势)
    ↓ analysis
AI Model Node (生成交易建议)
    ↓ recommendation
Buy/Sell Node (执行交易)

节点配置：

{
  "doc_link": "https://docs.google.com/spreadsheets/d/1uQvzsNIkaan.../edit"
}

---

示例 2：加载策略配置

场景： 从 Google Sheets 读取交易策略配置。

工作流结构：

Google Sheet Input Node (读取策略配置)
    ↓ data { strategies }
Code Node (选择当前策略)
    ↓ active_strategy
Condition Node (根据策略参数决策)
    ↓
交易节点

---

Google Sheets 配置

1. 创建 Service Account

1. 访问 Google Cloud Console

2. 创建新项目或选择现有项目

3. 启用 Google Sheets API

4. 创建 Service Account

5. 下载 JSON 凭证文件

2. 共享 Google Sheets

1. 打开您的 Google Sheets

2. 点击右上角的「共享」按钮

3. 添加 Service Account 邮箱地址

4. 授予「查看者」权限即可

3. 配置凭证

环境变量（推荐）：

export GOOGLE_CREDENTIALS_PATH="/path/to/credentials.json"

---

最佳实践

1. 表头设计

推荐：

| date       | symbol | price  | volume  |  # 小写，简洁
| Date       | Symbol | Price  | Volume  |  # 首字母大写

避免：

| 日期 | 代币 | 价格 | 交易量 |  # 中文列名可能导致问题

2. 数据格式

在 Google Sheets 中：

• 日期：使用 ISO 格式 YYYY-MM-DD

• 数字：避免使用逗号分隔符

• 布尔值：使用 TRUE/FALSE 或 1/0

• 空值：留空，不要使用 null 或 N/A

---

注意事项

重要提示

1. Google API 配额

   • 每天有读取次数限制

   • 避免在循环中频繁读取

   • 考虑缓存数据

2. 凭证文件安全

   • 不要将凭证文件提交到 Git

   • 使用环境变量配置路径

   • 限制 Service Account 权限

3. 数据类型

   • 所有数据读取为字符串

   • 需要在 Code Node 中进行类型转换

---

故障排查

Q: 提示 "Google Sheets credentials file not found"？

A:

1. 确认凭证文件路径正确

2. 检查环境变量 GOOGLE_CREDENTIALS_PATH

3. 确保凭证文件可读

---

Q: 提示 "Spreadsheet not found"？

A:

1. 确认 Sheet ID 正确

2. 检查 Service Account 是否有访问权限

3. 确认 Google Sheets 已共享

---

Q: 读取的数据为空？

A:

1. 确认工作表中有数据

2. 检查 Google Sheets 共享设置

3. 验证凭证是否正确

---

技术规格

规格项	值
节点版本	0.1.0
数据源	Google Sheets
API	Google Sheets API v4
凭证类型	Service Account
权限要求	查看者
超时时间	60秒

---

相关节点

• Google Sheet Output Node - 写入数据到 Google Sheets

• Code Node - 处理读取的数据

• AI Model Node - 分析数据集

---

相关文档：

• 节点与工作流 - 节点基础概念

• Code Node - 数据处理节点

• Weather 语法 - 工作流文件格式