Apple Health 接入 Google Sheets:一张自动填充的表格
要把 Apple Health 数据导入 Google Sheets,必须由 iPhone App 发送,因为 Apple Health 没有 Google 可以读取的 API。用 Marrow 有两种免费方式:按计划把每天的数值发送到一个小型 Apps Script Web 应用,让表格自动填充,或者在 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,然后部署并批准权限请求。知道地址的人只能调用这个脚本,任何人都无法通过它读取表格。
- 复制 Web 应用的 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} |
这个脚本读取的 JSON 与每个 Marrow 自动化发送的相同,格式见自动化参考:
{"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 (long) 作为格式,然后轻点创建导出.
- 把文件分享到 Google Drive。
- 在 Sheets 中打开 File,然后选择 Import,再选择该文件。
CSV 每天一行、每个指标一列。CSV (long) 是 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 应用,就选它。详情见我们的比较。
- n8n、Zapier 或 Make。发送到 webhook,让工具用它自己的 Google Sheets 步骤追加行。如果你已经在用其中之一,又不想维护脚本,就选它。步骤:n8n、Zapier、Make.
- Apple 的 export.zip。如果想一次性获取全部历史,从“健康”App 导出,在浏览器中用我们的转换器转成 CSV,然后导入文件。这是一份快照,有新数据就需要重新导出。
- Apple 快捷指令可以把几个健康样本发送到同一个 Web 应用。如果每天只需要一两个数字,又不介意逐个搭建,就选它。