此步驟使用指定的列對應值為 Google Sheets 工作表新增一行。

配置
在 Google 試算表中新增一行有三個關鍵配置:
Google 試算表
工作表(標籤)
列映射
選擇您想要填入的 Google Sheets 檔案。
確保您具有對您嘗試連線的工作表的編輯權限。
一旦您'選擇了所需的 Google Sheets 文件,請選擇您想要填入的工作表或標籤。
確保工作表名稱不包含標點符號,且工作表的第一行為標題行,已填寫欄位名稱。如果 A 列'的第一行缺少值,則資料將插入到工作表的頂部,而不是底部。
確定工作表或標籤後,打開列映射配置抽屜。您最多可以設定 26 列(A 列至 Z 列)。
在欄位中填寫所需資料。若要包含變量,請使用 "$" 前綴來支援靜態文字和變數的內插。您也可以使用系統變數作為列對應值來在新增新的 Google Sheet 行時新增時間戳,從而幫助您追蹤事件。
對於 Google Sheets 計算,在相關欄位中新增公式,以便在工作表中新增行時自動計算並顯示值。
如果您想在工作表中留空某一列,請將配置抽屜中的對應欄位留空。
若要更新工作表和列映射字段,請按一下配置抽屜中的刷新按鈕。
工作原理
當觸發工作流程時,列對映欄位中指定的值將會新增至 Google Sheets 工作表中,並在表格底部建立新行來顯示資料。

編輯工作表時,首先停止工作流程。然後,在重新發布工作流程之前更新步驟配置抽屜中的列欄位以反映變更。如果不這樣做可能會導致工作流程輸入和工作表中的新行之間的資料不符。
編輯工作表涉及以下操作:
刪除現有的行或列
在工作表底部以外的任何位置新增行
更改工作表的列排序
重新命名、新增或重新排列列
重新命名工作簿或工作表
潛在失敗
新增 Google 試算表行步驟可能會遇到兩種潛在的失敗:
缺少對所選 Google Sheets 檔案的編輯權限。
選定的工作表已達到其儲存格限製或已滿。
在某些情況下,由於超過 Google 的 API 限額,數據可能無法傳送到 Google Sheets 當處理大量數據時,這種情況更可能發生
如果發生速率限制 (429) 錯誤,該步驟會自動重試最多 3 次,每次相隔 1 分鐘,然後才會失敗。在重試進行期間,工作流程將保持等待狀態。如果任一重試成功,該步驟將正常繼續。如果所有 3 次重試都失敗,或以其他方式超過配額,將不會新增任何新行,聯絡人會略過此步驟並繼續工作流程的其餘步驟。
最佳實務
您可以遵循下列針對此步驟的最佳做法,以優化工作流程:
設定步驟後,請避免更新工作表標籤名稱或主工作表名稱。這樣做會停止工作表中的資料填入,並需要重新設定該步驟。
在設定工作流程步驟之前,請先在 Google 試算表中定義所需的標題。
避免在空白行中使用複選框、下拉式選單或其他預填格式,因為這些被視為值。這可能會導致資料填充到意外的行中。使用空白試算表或專門劃出沒有此類格式的區域,以獲得更可預測的行為。
在發送大量數據時,考慮分批或分散請求,以避免超過 Google 的 API 限額。
建議用例
以下是一些您可以使用 Add Google Sheets Row 步驟的方法:
透過自動資料輸入節省時間:將資料自動新增至 Google 試算表,減少手動作業。連接 Google 試算表以建立新行,並將變數新增至特定欄位。
常見問題與故障排除
為什麼會看到錯誤 "Token could not be fetched"?
此錯誤通常發生在將新的 Add Google Sheets Row 步驟新增到工作流程時,已連接的 Google 帳戶存取令牌已過期,導致 respond.io 無法驗證 Google 試算表。
要解決此問題,請按照下列步驟操作:
前往 新增 Google 試算表行 步驟。
斷開已連接的 Google 帳戶,然後重新連線並重新授權。
授予所有 Google 試算表與 Google Drive 所要求的權限。
請確認您使用的是具有該試算表存取權限的相同 Google 帳戶。
重新選擇試算表和工作表,儲存工作流程,然後再次測試。
或者,您也可以嘗試連接不同的 Google 帳戶。
如果問題仍然存在,請 聯絡支援 以獲得進一步協助。