將 Apple 健康資料同步到 Google Drive

Google Drive 自動化可將健康資料自動備份到 Google Drive。檔案可匯出為 JSON 或 CSV。也可選擇將 CSV 轉為 Google 表格。

概述

Google Drive 自動化會將健康資料上傳到您 Google 帳戶中的指定資料夾。檔案按日期範圍（日、周、月或年）組織，可在任何能訪問 Google Drive 的裝置上使用。

適用場景：

• 健康資料自動雲端備份
• 在多台裝置上訪問健康資料
• 與醫療服務提供者共享資料
• 長期歸檔
• 創建 Google 表格以便分析與協作
• 與 Google Workspace 工具整合

限制：

• 健康資料存取： iPhone 鎖定時應用程式無法存取健康資料。自動化僅在裝置解鎖期間執行，可能影響資料新鮮度。請參閲手動同步説明以保持資料最新。

• 背景處理： 為節省電量，iOS 會限制背景處理。自動化依賴「背景應用程式重新整理」，在以下情況可能不會立即執行：

  • 已為該應用程式關閉背景應用程式重新整理
  • 裝置處於低電量模式
  • 裝置長時間未活動
  • 系統資源緊張
  • 多個應用程式競爭背景執行時間

前提條件

• 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 的其他服務