Google Sheet Output Node

Google Sheet Output Node 用于向 Google Sheets 写入数据，是数据输出类节点。节点自动处理数据格式转换，将上游节点的数据持久化到 Google Sheets。

---

节点信息

属性	值
节点类型	gsheet_output_node
显示名称	Google Sheet Output
节点分类	Output（数据输出）
图标	📊 Sheet 图标（绿色）
句柄颜色	Rose（玫瑰红）

---

功能说明

Google Sheet Output Node 将上游节点的数据写入 Google Sheets，用于数据持久化、日志记录和结果导出。

主要用途：

• 保存交易记录

• 导出分析结果

• 记录日志数据

• 持久化配置

• 备份重要数据

核心特性：

• 💾 Google Sheets 集成：直接写入 Google Sheets

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

• 📋 表头生成：自动创建表头行

• ✍️ 覆盖写入：覆盖现有数据

---

输入参数

参数列表

参数	类型	必填	默认值	说明
data	object	✅	-	要写入的数据（JSON 格式）
doc_link	text	❌	-	Google Sheets URL 或 ID

data 参数

来源： 上游节点输出

期望格式：

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

示例输入：

{
  "headers": ["Date", "Symbol", "Action", "Price", "Profit"],
  "rows": [
    ["2024-01-15", "BTC", "Buy", "45000", "1200"],
    ["2024-01-16", "ETH", "Sell", "2500", "350"],
    ["2024-01-17", "APT", "Buy", "10", "-50"]
  ]
}

支持的数据格式：

1. 标准格式：包含 headers 和 rows

2. 对象数组：[{col1: val1, col2: val2}, ...]

3. 嵌套对象：自动扁平化

doc_link 参数

支持的格式：

1. 完整 URL：

https://docs.google.com/spreadsheets/d/1uQvzsNIkaan67wFijnDiixusw9qNZnedW4Q3dWJASBM/edit

1. Sheet ID：

1uQvzsNIkaan67wFijnDiixusw9qNZnedW4Q3dWJASBM

---

输出参数

Google Sheet Output Node 没有输出参数（终端节点）。

---

使用示例

示例 1：保存交易记录

场景： 将交易历史保存到 Google Sheets。

工作流结构：

Vault Node (获取金库信息)
    ↓ vault_balance
Swap Node (执行交易)
    ↓ trade_receipt { tx_hash, amount_in, amount_out }
Code Node (格式化交易记录)
    ↓ formatted_data
Google Sheet Output Node (保存到 Google Sheets)

Code Node 输出：

{
  "headers": ["Timestamp", "From", "To", "Amount_In", "Amount_Out", "TX_Hash"],
  "rows": [
    ["2024-01-15 10:30:00", "USDT", "APT", "100", "13.79", "0x1234..."]
  ]
}

节点配置：

{
  "doc_link": "1uQvzsNIkaan67wFijnDiixusw9qNZnedW4Q3dWJASBM"
}

---

示例 2：导出分析结果

场景： 将 AI 分析结果导出到 Google Sheets。

工作流结构：

X Listener Node (获取推文)
    ↓ latest_tweets
AI Model Node (情绪分析)
    ↓ ai_response { sentiment_score, key_points }
Code Node (整理分析结果)
    ↓ analysis_data
Google Sheet Output Node (导出结果)

analysis_data 格式：

{
  "headers": ["Date", "Source", "Sentiment", "Score", "Summary"],
  "rows": [
    ["2024-01-15", "@elonmusk", "Positive", "0.85", "Bullish on Bitcoin"],
    ["2024-01-16", "@VitalikButerin", "Neutral", "0.50", "Discussing ETH upgrade"]
  ]
}

---

示例 3：日志记录

场景： 记录工作流执行日志。

工作流结构：

任意节点（执行操作）
    ↓
Code Node (收集日志信息)
    ↓ log_data
Google Sheet Output Node (保存日志)

log_data 示例：

{
  "headers": ["Timestamp", "Node", "Status", "Message", "Duration"],
  "rows": [
    ["2024-01-15 10:30:00", "Vault Node", "Success", "Retrieved balance", "1.2s"],
    ["2024-01-15 10:30:02", "Swap Node", "Success", "Swap executed", "3.5s"]
  ]
}

---

Google Sheets 配置

配置要求

1. 创建 Service Account

2. 启用 Google Sheets API

3. 下载凭证文件

4. 共享 Google Sheets（需要「编辑者」权限）

权限要求：

• Google Sheet Input: 「查看者」即可

• Google Sheet Output: 必须「编辑者」权限

---

最佳实践

1. 数据格式化

在 Code Node 中格式化：

# 示例 Code Node
import pandas as pd

# 假设 input_data 是上游数据
df = pd.DataFrame(input_data)

# 格式化输出
output_data = {
    "headers": df.columns.tolist(),
    "rows": df.values.tolist()
}

2. 数据验证

在写入前验证：

# Code Node 中
if len(rows) == 0:
    raise ValueError("No data to write")

if len(headers) != len(rows[0]):
    raise ValueError("Headers and data columns mismatch")

---

注意事项

重要提示

1. 覆盖警告

   • Google Sheet Output Node 会覆盖现有数据

   • 写入前确认目标工作表

   • 建议使用不同工作表名称

2. 权限要求

   • Service Account 必须有「编辑者」权限

   • 仅「查看者」权限会导致写入失败

3. 数据格式

   • 必须提供 headers 和 rows

   • 所有行的列数必须一致

   • 数据会被转换为字符串

4. API 配额

   • 每天有写入次数限制

   • 大量写入可能触发限制

   • 考虑批量写入

5. 并发写入

   • 避免多个节点同时写入同一工作表

   • 可能导致数据冲突

---

故障排查

Q: 提示 "Permission denied"？

A:

1. 确认 Service Account 有「编辑者」权限

2. 重新共享 Google Sheets

3. 检查凭证文件是否正确

---

Q: 数据写入后格式混乱？

A:

1. 检查 headers 和 rows 的列数是否一致

2. 确认所有行的长度相同

3. 验证数据格式

---

Q: 提示 "No input data received"？

A:

1. 确认上游节点正确发送了 data 信号

2. 检查数据连接是否正确

3. 验证数据格式符合要求

---

技术规格

规格项	值
节点版本	0.1.0
写入模式	Write（覆盖）
数据源	Google Sheets
API	Google Sheets API v4
权限要求	编辑者
超时时间	60秒

---

相关节点

• Google Sheet Input Node - 从 Google Sheets 读取数据

• Code Node - 格式化要写入的数据

• AI Model Node - 生成分析结果

• Swap Node - 生成交易记录

---

相关文档：

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

• Google Sheet Input Node - 数据读取节点

• Code Node - 数据处理节点