Marrow
繁
下載

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 直接傳送到你試算表中的腳本。

  1. 在 Google Sheets 中建立新試算表。開啟 Extensions,再開啟 Apps Script.
  2. 把程式碼換成這份範例,並把 SECRET 改成你自己的一串長隨機字串。
  3. 點一下 Deploy,再點 New deployment,然後選擇 Web app。把 Execute as 設為 Me,Who has access 設為 Anyone,接著部署並核准權限提示。任何知道網址的人都只能呼叫這個腳本,沒有人能透過它讀取試算表。
  4. 複製網頁應用程式的 URL。它的結尾是 /exec.
  5. 在 Marrow 中開啟連線,再開啟匯出分頁,點一下 Google Sheets。開啟自動化,然後點新增自動化操作.
  6. 在網址中貼上 URL,然後加上 ?key= 和你的密鑰。看起來像 https://script.google.com/macros/s/…/exec?key=…。Apps Script 無法讀取標頭,所以密鑰要放在網址裡。
  7. 在資料下,資料類型維持健康指標,格式維持 JSON,格式(形狀)維持巢狀。在頻率下選擇執行的頻率。對試算表來說,一天一次就很夠了。
  8. 點一下立即執行。資料列會出現在名為 Marrow 的工作表中。

會收到什麼

每項指標每天一列,使用 Apple Health 儲存的單位。範例數值:

received_atmetricunitsdateqtyextra
2026-11-06 09:00step_countcount2026-11-058746
2026-11-06 09:00body_masskg2026-11-0581.3
2026-11-06 09:00heart_ratebpm2026-11-05{"Avg":71,"Min":52,"Max":148}
2026-11-06 09:00sleep_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

如果只想看一次你的數字,可以跳過腳本。

  1. 在 Marrow 中開啟連線,再開啟匯出分頁,然後點手動.
  2. 在每日指標下設定範圍,選擇 CSV 或 CSV(長格式)作為格式,然後點一下建立匯出.
  3. 把檔案分享到 Google Drive。
  4. 在 Sheets 中開啟 File,再開啟 Import,然後選擇檔案。

CSV 每天一列、每項指標一欄。CSV(長格式)是 date,metric,value,unit,正是樞紐分析表需要的格式。每個檔案都在檔案參考中有說明.

如果沒有用

常見問題

這是免費的嗎?

是的。自動化操作和檔案匯出都包含在 Marrow 的免費方案中,Apps Script 只要有 Google 帳號也是免費的。開啟中的自動化操作會佔用免費方案三個連線中的一個。

App 關閉時試算表也會更新嗎?

會。自動化操作會在 iOS 允許的時候於背景執行,通常一天好幾次。

最遠可以回溯多久?

Marrow 讀取了多少就能回溯多少。預設是三年的 Apple Health 歷史資料,在設定、資料類型、Apple Health 歷史紀錄中可以延長到五年、全部,或從某個日期開始。第一次載入時,在更多選項下設定自動化操作的日期範圍,執行一次後,再改回「自上次執行以來」。

Google 能看到我的健康資料嗎?

資料列存放在你自己的 Google 試算表中,適用你 Google 帳號的條款。Marrow 從你的手機傳送到你的腳本,我們的伺服器上不會保留任何複本。

其他做法,以及何時選擇它們

相關內容:Apple Health 轉 CSV · Apple Health 傳送到 webhook · 自動化操作參考