前言
把資料放進 Google Sheets、再串到 CRM／電商／通知系統，是很多流程的起點。n8n 的 Google Sheets 節點能幫你：
- 建立/刪除試算表（Document 層級），設定 Locale 與 Recalculation Interval。
- 讀/寫/清空/增刪工作表與資料列（Sheet 層級），含 Append / Update、清除整表或特定範圍（A1 表示法）。
- 觸發自動化（工作表變更時啟動工作流程）。
開始前，先在 Google Cloud Console 建專案 → 啟用 Sheets API / Drive API → 建立 OAuth，把憑證填回 n8n 認證；之後就能用文件/工作表操作把資料自動化進出。
Google Sheets 節點簡介
Google Sheets 節點讓您能夠自動化 Google Sheets 中的工作，並將 Google Sheets 與其他應用程式整合。
建立與刪除
建立新試算表或刪除現有試算表
讀取與寫入
讀取、新增、更新或刪除工作表中的資料
自動化觸發
當工作表變更時自動執行工作流程
認證設定 (Credentials)
在使用 Google Sheets 節點之前，您需要設定認證以進行身份驗證。
建立 Google 專案
在 Google Cloud Console 中建立新專案
啟用 API
啟用 Google Sheets API 和 Google Drive API
設定 OAuth
建立 OAuth 憑證並設定重定向 URI
在 n8n 中設定
將憑證資訊輸入 n8n 的認證設定中
詳細設定指南請參考：Google Sheets credentials
文件操作 (Document Operations)
Google Sheets 節點支援以下文件層級操作：
建立試算表 (Create)
建立新的 Google Sheets 試算表文件
- 設定試算表標題
- 建立初始工作表
- 設定地區和重新計算間隔
刪除試算表 (Delete)
永久刪除現有的 Google Sheets 試算表
- 透過列表選擇
- 透過 URL 指定
- 透過 ID 指定
建立試算表 (Create Spreadsheet)
選擇資源類型
在節點設定中，選擇 資源 (Resource) 為 文件 (Document)
選擇操作
將 操作 (Operation) 設定為 建立 (Create)
設定標題
輸入新試算表的 標題 (Title)
新增工作表
指定要在試算表中建立的 工作表 (Sheets) 標題
您也可以設定選項如 地區 (Locale) 和 重新計算間隔 (Recalculation Interval)
建立試算表 – 選項設定
地區 (Locale)
設定試算表的地區，影響格式化細節如函數、日期和貨幣。
- en (639-1 格式)
- fil (639-2 格式)
- en_US (ISO 語言和國家組合)
參考：ISO 639 語言代碼 和 ISO 3166 國家代碼
重新計算間隔 (Recalculation Interval)
設定試算表函數的重新計算間隔，影響 NOW、TODAY、RAND 和 RANDBETWEEN 的更新頻率。
- 變更時 (On Change)：當試算表有變更時重新計算
- 每分鐘 (Minute)：每分鐘重新計算
- 每小時 (Hour)：每小時重新計算
刪除試算表 (Delete Spreadsheet)
選擇資源類型
在節點設定中，選擇 資源 (Resource) 為 文件 (Document)
選擇操作
將 操作 (Operation) 設定為 刪除 (Delete)
選擇文件
指定要刪除的試算表：
- 從列表 (From list)：從下拉列表中選擇
- 透過 URL (By URL)：輸入試算表的 URL
- 透過 ID (By ID)：輸入試算表 ID
試算表 ID 可在 Google Sheets URL 中找到：
https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0
工作表操作 (Sheet Operations)
Google Sheets 節點支援多種工作表層級操作：
新增與更新
新增或更新工作表中的資料列
建立與刪除
建立新工作表或刪除現有工作表
清除
清除工作表中的資料
讀取
讀取工作表中的資料列
新增或更新資料列 (Append or Update Row)
此操作用於更新現有資料列或在找不到匹配項時在資料末尾新增資料列。
選擇資源與操作
選擇 資源 (Resource) 為 工作表 (Sheet Within Document)，操作 (Operation) 為 新增或更新資料列 (Append or Update Row)
選擇文件與工作表
指定要操作的試算表和工作表
設定欄位映射模式
選擇 手動映射每個欄位 (Map Each Column Manually)、自動映射 (Map Automatically) 或 無 (Nothing)
設定選項
設定 儲存格格式 (Cell Format)、工作表上的資料位置 (Data Location on Sheet) 等選項
新增資料列 (Append Row)
此操作用於在工作表資料末尾新增資料列。
基本設定
- 選擇 資源 (Resource) 為 工作表 (Sheet Within Document)
- 選擇 操作 (Operation) 為 新增資料列 (Append Row)
- 選擇要操作的文件和工作表
- 設定欄位映射模式
選項設定
- 儲存格格式 (Cell Format)：選擇如何格式化儲存格中的資料
- 工作表上的資料位置 (Data Location on Sheet)：指定資料範圍
- 處理輸入中的額外欄位 (Handling extra fields in input)：決定如何處理不匹配的欄位
- 使用附加 (Use Append)：使用 Google API 附加端點來新增資料列
清除工作表 (Clear Sheet)
此操作用於清除工作表中的資料。
整個工作表 (Whole Sheet)
清除整個工作表的資料
可選擇保留第一列 (Keep First Row)
特定資料列 (Specific Rows)
清除特定資料列的資料
需指定起始列號和要刪除的列數
特定欄位 (Specific Columns)
清除特定欄位的資料
需指定起始欄位和要刪除的欄位數
特定範圍 (Specific Range)
清除特定範圍的資料
使用 A1 表示法指定表格範圍
清除操作會永久刪除資料，請謹慎使用。
建立新工作表 (Create Sheet)
此操作用於在現有試算表中建立新工作表。
基本設定
- 選擇 資源 (Resource) 為 工作表 (Sheet Within Document)
- 選擇 操作 (Operation) 為 建立 (Create)
- 選擇要在其中建立新工作表的試算表
- 輸入新工作表的 標題 (Title)
選項設定
- 隱藏 (Hidden)：在 UI 中隱藏工作表
- 從右到左 (Right To Left)：使用 RTL 工作表而非 LTR 工作表
- 工作表 ID (Sheet ID)：指定工作表 ID
- 工作表索引 (Sheet Index)：指定新工作表的索引位置
- 標籤顏色 (Tab Color)：設定 UI 中標籤的顏色
刪除工作表 (Delete Sheet)
此操作用於永久刪除工作表。
選擇資源類型
選擇 資源 (Resource) 為 工作表 (Sheet Within Document)
選擇操作
將 操作 (Operation) 設定為 刪除 (Delete)
選擇文件
選擇包含要刪除工作表的試算表
選擇工作表
指定要刪除的工作表：
- 從列表 (From list)
- 透過 URL (By URL)
- 透過 ID (By ID)
- 透過名稱 (By Name)
刪除操作無法復原，請謹慎使用。
總結
- 認證與文件操作
- 流程：建專案 → 開 API（Sheets/Drive）→ 建 OAuth（填 Redirect URI）→ 在 n8n 建立 Credentials。
- Create Spreadsheet：設定
Title、初始Sheets、Locale（如en_US/fil）、Recalculation Interval（On Change / Minute / Hour）。 - Delete Spreadsheet：以 From list / By URL / By ID 指定；
ID來自https://docs.google.com/spreadsheets/d/<ID>/edit#gid=0。
- 工作表與資料列操作
- Append or Update Row：先找匹配（依映射）→ 有則更新、無則附加；映射模式：Map Each Column Manually / Map Automatically / Nothing；可調 Cell Format、Data Location。
- Append Row：直接在尾端新增；可用 Use Append（Google API append 端點），處理額外欄位策略可選。
- Clear Sheet：整表／特定列／特定欄／特定範圍（A1）；可選保留首列。此操作不可復原，務必小心。
- Create Sheet：在現有試算表中新增分頁；可設
Hidden、Right To Left、Sheet ID/Index、Tab Color。 - Delete Sheet：以 From list / By URL / By ID / By Name 指定；不可復原。
- 實務心法
- 欄位對齊：先在表頭定義欄位，選擇手動映射可控性最高；自動映射適合欄位名穩定一致的情境。
- 定位與範圍：大量寫入前先設定 Data Location 與固定範圍，避免覆蓋非預期區域。
- 效能與配額：批量寫入時以 Append、合併多筆為一次請求，並在流程加上節流/重試。
- 格式與重新計算：需要即時更新
NOW()/TODAY()/RAND()才調高 Recalc 頻率；否則維持預設可省資源。 - 安全與備援：重大清除/刪除前先備份；權限最小化（最小可用範圍），避免憑證外洩。
- 定位文件：偏好用 ID 指定文件/工作表，避免 URL/名稱變動造成失敗。
- 觸發自動化：配合「工作表變更觸發」把資料流接到後續清洗、通知、寫庫或報表流程。
把這些操作與最佳實踐串起來，你就能用 n8n 把 Google Sheets 變成穩定的資料入口 / 報表出口 / 自動化中繼站。
