HealthyApps Help Center

将 Apple 健康数据同步到 Google Drive

设置自动将健康数据同步到 Google Drive。

Last updated: May 6, 2026

本页目录

Google Drive 自动化可将健康数据自动备份到 Google Drive。文件可导出为 JSON 或 CSV。也可选择将 CSV 转为 Google 表格。

概述

Google Drive 自动化会将健康数据上传到您 Google 账户中的指定文件夹。文件按日期范围（日、周、月或年）组织，可在任何能访问 Google Drive 的设备上使用。

适用场景：

  • 健康数据自动云端备份
  • 在多台设备上访问健康数据
  • 与医疗服务提供者共享数据
  • 长期归档
  • 创建 Google 表格以便分析与协作
  • 与 Google Workspace 工具集成

限制：

  • 健康数据访问： iPhone 锁定时应用无法访问健康数据。自动化仅在设备解锁期间运行，可能影响数据新鲜度。请参阅手动同步说明以保持数据最新。

  • 后台处理： 为节省电量，iOS 会限制后台处理。自动化依赖“后台 App 刷新”，在以下情况可能不会立即运行：

    • 已为该应用关闭后台 App 刷新
    • 设备处于低电量模式
    • 设备长时间未活动
    • 系统资源紧张
    • 多个应用竞争后台执行时间

前提条件

  • Google 账户
  • 网络连接
  • 已启用 Google Drive 访问权限

配置

在主界面导航至“自动导出”屏幕，轻点“New Automation”，并将自动化类型选为“Google”。

自动化名称

输入易于识别的名称（例如 “Daily Health Backup”、“Weekly Health Export”）。该名称将用作 Google Drive 中的文件夹名称。

通知

选择何时接收通知：

  • Notify on Cache Update — 缓存数据更新时通知
  • Notify When Run — 每次自动化上传数据时通知

Google Drive 连接

在配置其他选项前，必须先连接 Google 账户。

连接 Google Drive

  1. 轻点 “Connect Google”
  2. 将跳转到 Google 授权页面
  3. 按提示登录 Google 账户
  4. 查看应用请求的权限
  5. 轻点 “Allow” 授权应用
  6. 返回应用

说明： 应用请求在 Google Drive 中创建和管理文件的权限，仅访问其创建的文件夹，不会访问整个 Google Drive。

请求的权限：

  • 查看和管理 Google Drive 中的文件
  • 创建和编辑 Google 表格（若转换为表格）

管理连接

连接后可管理 Google Drive 连接：

  1. 在 Google 配置区域轻点 “Manage Connection”
  2. 查看连接状态
  3. 必要时重新连接
  4. 若要更换账户可断开连接

连接状态：

  • 已连接：绿色对勾或已确认连接
  • 未连接：红色提示或仍显示 “Connect Google”

高级：Google Drive 文件夹 ID

Google 连接界面包含以下可编辑的高级字段：

  • Google Drive 根文件夹 ID — 共享的顶级 Health Auto Export 文件夹的 ID。
  • Google Drive 备份文件夹 ID — 当前自动化写入文件所用的、每个自动化对应的子文件夹 ID。

这些字段仅用于恢复或迁移工作流。输入无效 ID 可能会导致上传失败，直到 ID 被纠正。

文件夹名称

输入用于保存健康数据的 Google Drive 文件夹名称。

名称示例：

  • Health Data
  • Daily Backup
  • Health Exports
  • My Health Metrics

说明： 若文件夹不存在，将在 Google Drive 根目录自动创建。应用会先创建根文件夹 “Health Auto Export”，再按您填写的名称创建子文件夹。

自定义文件名

对于 Google Drive 自动化，你可以选择性地设置自定义文件名前缀。

  • 若留空，导出会使用默认命名。
  • 若已设置，该前缀会用于 JSON 文件，并加在 CSV 样式名称的前面。
  • 不适用于文件名的字符会被自动清理。

前缀示例：

  • HealthBackup
  • DailyExport
  • CustomName

数据类型设置

数据类型

选择要导出的健康数据类型：

  • Health Metrics — 步数、心率、睡眠等测量值
  • Workouts — 运动与健身活动
  • Symptoms — 症状与状况
  • ECG — 心电图记录
  • Heart Rate Notifications — 心率过高/过低事件
  • State of Mind — 情绪与心理状态记录（iOS 18.0+）
  • Cycle Tracking — 月经周期与生殖健康数据
  • Medications — 用药记录与依从性（iOS 26.0+）

Health Metrics 配置

选择 Health Metrics 时：

Select Health Metrics — 选择要包含的指标，可选全部或部分。

提示： 仅选择需要的指标可减小文件体积并加快上传。

Preferred Sources — 当多个来源提供同一指标时，设置优先来源。

Workout 配置

选择 Workouts 时：

Include Route Data — 若运动包含位置数据，打开以包含路线。

Include Workout Metrics — 打开以包含运动期间采集的指标（心率、卡路里等）。

说明： 包含运动指标需要额外查询，可能增大文件并延长处理时间。

Time Grouping (Workout Metrics) — 使用导出版本 2 且启用 Include Workout Metrics 时：

  • Minutes — 按分钟汇总运动指标
  • Seconds — 按秒汇总运动指标

导出设置

导出格式

选择导出格式：

  • JSON format — 嵌套对象结构，适合应用、数据库与详细分析；对睡眠阶段、房颤等复杂类型信息更完整。

  • CSV format — 表格数据，便于导入电子表格。启用 “Convert to Google Sheet” 时，CSV 会自动转为 Google 表格。

提示： 全面存储用 JSON，便于查看与协作用 CSV。

Export Version

选择导出版本。版本化可按您自己的节奏升级，减少对现有流程的冲击。

  • Version 1 — 旧版格式，若现有流程依赖此格式请使用
  • Version 2 — 当前格式，包含更丰富的运动数据与元数据选项

Convert to Google Sheet

使用 CSV 时可打开或关闭 “Convert to Google Sheet”。

  • 打开 — CSV 自动转为 Google 表格（默认）
  • 关闭 — 以普通 CSV 文件上传

Google 表格的优势：

  • 在 Google Drive 中直接查看与编辑
  • 便于与他人共享
  • 可使用图表、公式等功能
  • 任何能使用 Google Drive 的设备均可访问
  • 支持实时协作

说明： 仅在导出格式为 CSV 时适用。JSON 始终以 JSON 文件上传。

Date Range

选择如何按文件组织数据：

  • Day — 每天单独文件
  • Week — 每周单独文件
  • Month — 每月单独文件
  • Year — 每年单独文件

文件组织：

  • 文件名反映所包含的日期范围
  • 每个文件包含该时段内的全部数据
  • 文件保存在“文件夹名称”指定的文件夹中
  • 应用会创建根文件夹 “Health Auto Export” 及对应子文件夹

Summarize Data

对 JSON 且数据类型为 Health Metrics 时，可打开或关闭 Summarize Data。

  • 打开 — 提供汇总数据（默认）
  • 关闭 — 在可能的情况下提供非汇总、逐点数据

说明： 仅适用于 JSON + Health Metrics。使用 CSV 或选择多项指标时，数据始终为汇总形式。

Time Grouping

选择文件内数据的汇总粒度。可选范围取决于所选的 Date Range。

说明： 更细粒度（分钟/小时）文件更大、细节更多；较粗粒度（日/周/月）文件更小、为摘要数据。

同步频率

设置自动化向 Google Drive 上传数据的频率：

选择数字与时间单位。

测试与验证

手动测试

  1. 在自动化配置界面轻点 “Manual Export”
  2. 选择日期范围
  3. 轻点 “Export” 上传文件
  4. 在 Google Drive 文件夹中确认文件已上传

在 Google Drive 中核对文件

  1. 打开 Google Drive 应用或网站
  2. 进入 “Health Auto Export” 文件夹
  3. 打开与自动化名称对应的子文件夹
  4. 确认文件名与日期符合预期
  5. 查看文件大小确认上传完整
  6. 打开文件确认格式正确

若为 Google 表格：

  • 显示为 Google 表格
  • 可直接在表格中打开
  • 支持实时协作

若为 JSON/CSV：

  • 显示为普通文件
  • 可下载或用兼容应用打开
  • JSON 可用文本编辑器查看

查看活动日志

  1. 在自动化配置界面轻点 “View Activity Logs”
  2. 查看近期运行记录
  3. 检查上传错误或连接问题
  4. 核对上传时间戳

故障排除

常见问题

“Token error: No Google token found. Try connecting Google again.”

  • 轻点 “Connect Google” 重新授权
  • 确认已完成授权流程
  • 确认在 Google 页面轻点了 “Allow”
  • 确认 Google 账户有效

连接/令牌错误

  • 轻点 “Manage Connection” 重新连接
  • 检查网络
  • 确认账户状态
  • 令牌过期时重新授权
  • 确认账户已启用 Google Drive

Google Drive 中看不到文件

  • 检查网络
  • 确认文件夹名称正确
  • 路径：“Health Auto Export” > [您的文件夹名]
  • 在活动日志中查看上传错误
  • 确认自动化已启用

错误信息

在以下情况应用会显示错误：

  • Google Drive 连接失败
  • 网络问题导致上传失败
  • Google Drive 存储空间不足
  • 文件夹名称或路径无效
  • 令牌刷新失败
  • 转为 Google 表格失败

请在活动日志中查看详细错误，包括 HTTP 状态码与 Google API 返回信息。

提示与最佳实践

  1. 自动同步：

    • 为设备充电并使用 iPhone 镜像
      • 充电时 iOS 对性能限制较少，数据可更频繁同步
      • 使用镜像时设备行为类似已解锁，Health Auto Export 可访问健康数据以运行自动化

  2. 文件格式：

    • 全面存档用 JSON
    • 需要查看与协作时对 CSV 启用转为表格
    • 按使用场景选择格式

  3. Google 表格：

    • 需要编辑查看的 CSV 请启用 “Convert to Google Sheet”
    • 协作与共享可使用表格
    • 善用图表、公式、数据透视表
    • 需要时可与医疗人员共享

  4. 数据选择：

    • 只选需要的指标以减小体积
    • 可按指标分组创建多个自动化
    • 便于整理并减小单文件大小

  5. 访问：

    • 任何能登录 Google Drive 的设备均可访问
    • 可使用 Google Drive 移动应用
    • 也可在浏览器中访问
    • 文件会在设备间同步

  6. 集成：

    • 表格可与其他 Google Workspace 工具配合
    • 可从表格导出为其他格式
    • 可使用 Google Apps Script 自动化
    • 可对接能访问 Google Drive 的其他服务