Apple Health 匯入 Google Sheets:自動填寫的試算表
要把 Apple Health 資料匯入 Google Sheets,必須由 iPhone App 傳送,因為 Apple Health 沒有 Google 能讀取的 API。用 Marrow 有兩種免費方式:定時把每天的數字傳送到一個小型 Apps Script 網頁應用程式,讓試算表自動填寫,或在 App 中產生 CSV 再匯入一次。
下面介紹這兩種方式,以及你會得到的欄位和常見問題的解決方法。Marrow 是我們做的。這些步驟適用於 Marrow 1.7.1。
1. 自動填寫的試算表(Apps Script)
你需要一個 Google 帳號。中間不需要執行任何其他東西:Marrow 直接傳送到你試算表中的腳本。
- 在 Google Sheets 中建立新試算表。開啟 Extensions,再開啟 Apps Script.
- 把程式碼換成這份範例,並把
SECRET改成你自己的一串長隨機字串。 - 點一下 Deploy,再點 New deployment,然後選擇 Web app。把 Execute as 設為 Me,Who has access 設為 Anyone,接著部署並核准權限提示。任何知道網址的人都只能呼叫這個腳本,沒有人能透過它讀取試算表。
- 複製網頁應用程式的 URL。它的結尾是
/exec. - 在 Marrow 中開啟連線,再開啟匯出分頁,點一下 Google Sheets。開啟自動化,然後點新增自動化操作.
- 在網址中貼上 URL,然後加上
?key=和你的密鑰。看起來像https://script.google.com/macros/s/…/exec?key=…。Apps Script 無法讀取標頭,所以密鑰要放在網址裡。 - 在資料下,資料類型維持健康指標,格式維持 JSON,格式(形狀)維持巢狀。在頻率下選擇執行的頻率。對試算表來說,一天一次就很夠了。
- 點一下立即執行。資料列會出現在名為 Marrow 的工作表中。
會收到什麼
每項指標每天一列,使用 Apple Health 儲存的單位。範例數值:
| received_at | metric | units | date | qty | extra |
|---|---|---|---|---|---|
| 2026-11-06 09:00 | step_count | count | 2026-11-05 | 8746 | |
| 2026-11-06 09:00 | body_mass | kg | 2026-11-05 | 81.3 | |
| 2026-11-06 09:00 | heart_rate | bpm | 2026-11-05 | {"Avg":71,"Min":52,"Max":148} | |
| 2026-11-06 09:00 | sleep_analysis | 小時 | 2026-11-05 | {"totalSleep":7.4,"deep":1.1,"rem":1.6,"core":4.7} |
這個腳本讀取的是每個 Marrow 自動化操作都會傳送的同一種 JSON,說明見自動化操作參考:
{"data": {"metrics": [
{"name": "step_count", "units": "count",
"data": [{"date": "2026-11-05", "qty": 8746}]},
{"name": "heart_rate", "units": "bpm",
"data": [{"date": "2026-11-05", "Avg": 71, "Min": 52, "Max": 148}]}
]}}
有兩件事要知道。日期範圍自上次執行以來會刻意重新傳送最近兩天的資料,因為 Apple Health 在一天結束後還會繼續補資料,所以同一項指標和日期可能出現不只一次。要保留最新的,就先依 received_at 由新到舊排序,再對指標和日期欄使用 Data、Data cleanup、Remove duplicates。另外,這份範例處理的是健康指標。體能訓練、重訓組數和餐點也以相同的請求格式送達,所以多寫幾行腳本就能為它們新增工作表。
2. 匯入一次 CSV
如果只想看一次你的數字,可以跳過腳本。
- 在 Marrow 中開啟連線,再開啟匯出分頁,然後點手動.
- 在每日指標下設定範圍,選擇 CSV 或 CSV(長格式)作為格式,然後點一下建立匯出.
- 把檔案分享到 Google Drive。
- 在 Sheets 中開啟 File,再開啟 Import,然後選擇檔案。
CSV 每天一列、每項指標一欄。CSV(長格式)是 date,metric,value,unit,正是樞紐分析表需要的格式。每個檔案都在檔案參考中有說明.
如果沒有用
- 點了立即執行後沒有資料列。開啟 Apps Script 專案,點左側的 Executions。每一次 POST 都會顯示在那裡,包括任何錯誤。
- 顯示已傳送,卻沒有資料列。當
?key=和範例中的SECRET不符時,範例會回應 forbidden,而 Marrow 仍會視為成功。請檢查網址結尾的密鑰。 - 修改腳本沒有效果。點 Deploy、Manage deployments,編輯目前的部署,選擇新版本後再點 Deploy。在你這麼做之前,
/exec網址會一直執行舊版本。 - 位址以 /dev 結尾。那個位址只有已登入且有編輯權限的人才能執行。Marrow 需要的是
/exec位址。 - 腳本從來沒有執行。在部署設定中,Who has access 必須讓任何人不用登入就能存取。
- 匯入的檔案只顯示一長欄。請重新匯入,並選擇逗號作為分隔符號。
- 執行時間比較晚。背景工作的時機由 iOS 決定,一直鎖定的手機會在下次解鎖時才傳送。自動化操作何時執行說明了可以預期的情況。
常見問題
這是免費的嗎?
是的。自動化操作和檔案匯出都包含在 Marrow 的免費方案中,Apps Script 只要有 Google 帳號也是免費的。開啟中的自動化操作會佔用免費方案三個連線中的一個。
App 關閉時試算表也會更新嗎?
會。自動化操作會在 iOS 允許的時候於背景執行,通常一天好幾次。
最遠可以回溯多久?
Marrow 讀取了多少就能回溯多少。預設是三年的 Apple Health 歷史資料,在設定、資料類型、Apple Health 歷史紀錄中可以延長到五年、全部,或從某個日期開始。第一次載入時,在更多選項下設定自動化操作的日期範圍,執行一次後,再改回「自上次執行以來」。
Google 能看到我的健康資料嗎?
資料列存放在你自己的 Google 試算表中,適用你 Google 帳號的條款。Marrow 從你的手機傳送到你的腳本,我們的伺服器上不會保留任何複本。
其他做法,以及何時選擇它們
- Health Auto Export 的 Premium 方案可以定時把 CSV 檔儲存到 Google Drive。如果你想要的是 Drive 裡的一個檔案資料夾,或你也使用它的 Mac 和 iPad App,就選它。詳情請見我們的比較。
- n8n、Zapier 或 Make。傳送到 webhook,讓這些工具用它們自己的 Google Sheets 步驟附加資料列。如果你已經在用其中之一,又不想維護腳本,就選這個。步驟:n8n、Zapier、Make.
- Apple 的 export.zip。如果要一次取得全部歷史資料,就從「健康」App 匯出,用我們在瀏覽器中執行的轉換工具轉成 CSV,再匯入檔案。這是一份快照,有新資料就要重新匯出。
- Apple 捷徑可以把幾個健康樣本傳送到同一個網頁應用程式。如果每天只要一兩個數字,而且不介意每個都自己建立,就選它。
相關內容:Apple Health 轉 CSV · Apple Health 傳送到 webhook · 自動化操作參考