技術指南

Google Sheets 設定與資料管理

了解 WalletMap 如何使用 Google Sheets，以及如何直接管理你的資料。

1. 自動建立的運作方式

當你首次登入時，WalletMap 會自動在你的 Google Drive 中建立一個新的 Google Sheets 試算表。這透過 Google Sheets API 在背景無縫完成。試算表命名為「WalletMap」，位於你 Drive 的根目錄。

你的試算表包含獨立的工作表（分頁）：銀行帳戶、股票持倉、加密貨幣持倉和交易紀錄。每個工作表有一列標題列定義欄位，接著每筆記錄佔一列。欄位結構對應你在應用中看到的欄位 — 銀行名稱、餘額、股票代碼、股數等。

從 Google Drive 打開 Google Sheets 即可看到應用程式正在讀取的確切資料。這種透明度是核心功能 — 沒有隱藏的資料庫或伺服器端副本。你在試算表中看到的就是你資產記錄的唯一真實來源。

如有需要，你可以直接在 Google Sheets 中編輯資料。請小心維護欄位結構和資料格式。避免插入或刪除欄位，因為這可能會影響應用讀取資料的能力。在現有結構內新增或編輯資料列通常是安全的。

雖然 Google Drive 本身提供版本紀錄和備援機制，你可以使用 Google Sheets 的「檔案 > 建立副本」來建立額外備份。你也可以使用 WalletMap 設定頁面的 Excel 匯出功能下載本地副本。建議定期備份，特別是在手動編輯試算表之前。

Google Sheets 的工作表（tab）名稱跟欄位順序是 WalletMap 用來找資料的「介面契約」。刪掉某個 tab 或改名（例如把「股票」改成「Stocks」）會讓 App 找不到資料、儀表板就壞了。要修改的時候在你自己的副本上操作、不要動原檔。

如果你想加一個「自訂備註」欄位，請加在最右邊，不要插在現有欄位中間。我們的解析邏輯按欄位順序讀，中間插入會讓所有後續欄位錯位、餘額讀成幣別、幣別讀成類型，整張表就亂了。

如果你直接在 Google Sheets 改了餘額、刷新瀏覽器看到的可能還是快取的舊值（5 分鐘內）。要立刻看到最新狀態，可以登出再登入、或者等 5 分鐘讓 cache 失效。這是因為我們在 WalletMap 後端有報價快取，並非 Sheets 的問題。

WalletMap 的零儲存架構保護了我們這端，但你的 Google 帳號本身才是資料的真正所在地。如果 Google 帳號被弱密碼或釣魚攻破，攻擊者能看到所有 Sheets 內容——這超出我們的保護範圍。強烈建議啟用兩步驟驗證，這對任何把資料放在 Google Drive 的人都適用。

開始追蹤你的資產，享受完整的隱私保護。你的資料絕不離開你的 Google Drive。