Home Assistant へ Apple Health データを同期
ヘルスデータを Home Assistant と統合します。
最終更新: 2026年10月31日
このページの内容
ヘルス指標を個別のエンティティ状態として Home Assistant に公開します。この送信先はヘルス指標のみをサポートします。
重要 — 自動化の制限事項: ヘルスデータを読み取るにはデバイスのロック解除が必要で、iOS は選んだ頻度でのバックグラウンド実行を保証しません。自動エクスポートに頼る前に 自動化の制限事項 を確認してください。
自動化を開く
iPhone では エクスポート → 自動化 を、iPad ではサイドバーの 自動化 を開きます。新規自動化 を選ぶか、既存の自動化を開いて編集します。
名前、状態、通知
この自動化を識別する名前を入力します。有効 は自動実行を許可します。準備ができるまではオフのままにします。
必要な実行通知を選びます:
- キャッシュ更新時に通知 はエクスポートデータの準備完了を報告します。
- 実行時に通知 は Home Assistant への公開成功を報告します。
求められたら通知を許可します。これらの通知はアクティビティを報告するだけで、実行をスケジュールしません。
Home Assistant に接続
- 自動化の種類 として Home Assistant を選びます。
- Home Assistant インスタンスのベース URL を入力します(例:
http://homeassistant.local:8123)。 - Home Assistant のプロファイルで Long-Lived Access Token を作成します。
- HTTP ヘッダー の下に、
Authorizationを追加し、値をBearer YOUR_LONG_LIVED_ACCESS_TOKENにします。
Home Assistant インスタンスは iPhone または iPad から到達可能である必要があります。HTTPS の場合は、デバイスが信頼する証明書を使います。
ヘルス指標設定
ヘルス指標を選択 を開き、公開する測定値を選びます。
優先ソース を開き、各指標のソースを選びます。除外されていないすべてのソースには すべて を使い、この自動化全体でソースを無視するには 除外ソース を使います。除外が優先され、未選択のソースはデータがない優先ソースの代わりにはなりません。保存 で選択を適用し、キャンセル で破棄します。
エクスポート設定
Home Assistant は独自の JSON エンティティ状態形式を使うため、ファイル形式やエクスポートバージョンの選択はありません。
日付範囲
- デフォルト: 前日と、実行時刻までの本日を含めます。
- 今日: 実行時刻までの本日を含めます。
- 昨日: 直前の 1 全日を含めます。
時間グループ化
測定値をグループ化しない場合は デフォルト、日次要約を使う場合は 日 を選びます。Home Assistant に データを要約 トグルはありません。
スケジュールリマインダー
ロック解除とアプリ起動の促しが必要な場合は、リマインダーを有効にする をオンにします。毎時、毎日、または 選択した曜日 を選び、必要に応じて分、時刻、曜日を設定します。求められたら通知アクセスを許可し、拒否されている場合は 通知設定を開く を使います。
リマインダーは自動化を実行せず、同期成功も確認しません。タップして自動化を開くか、通知の 開いて同期 で実行を要求します。自動化は有効である必要があります。成功したバックグラウンド実行のあともリマインダーが表示されることがあります。リマインダーの変更は保存時に適用されます。
同期間隔と保存
同期間隔 で数値と 分 または 時間 を選びます。これは希望するバックグラウンドの間隔であり、保証されたスケジュールではありません。
ヘルスデータの読み取り時はデバイスのロック解除が必要です。Health Auto Export のバックグラウンド App の更新を有効にし、自動実行のため低電力モードをオフにします。デバイスが非アクティブだった場合やシステムリソースが限られている場合、iOS が実行を遅らせることがあります。
自動実行の準備ができたら 有効 をオンにし、更新 で自動化を保存します。下記の手順ですぐに選択した日付範囲をアップロードできます。
公開されるエンティティ
選択した各指標は 1 つ以上のエンティティを生成できます。識別子は hae. で始まり、続けてスペースなしの小文字の自動化名、指標、任意のコンポーネント名が続きます。
たとえば、Health Metrics という名前の自動化は、歩数を次に公開できます:
http://homeassistant.local:8123/api/states/hae.healthmetrics_step_count
状態は選択した日の最新の測定値で、測定単位の属性が付きます。血圧や心拍数などの指標は、コンポーネントごとの別エンティティを使います。
その日にデータがない場合、歩数やスタンド時間などの合計は 0 を公開します。体重や心拍数などのほかの測定値は、データが利用可能になるまで更新されないため、Home Assistant は受け取った最後の値を表示し続けることがあります。日の早い時間帯は、Watch のデータが iPhone に届くまで合計が 0 のままになることがあります。
履歴または漏れたデータをエクスポートする
自動化の初回設定時に履歴データをエクスポートする、またはあとから自動同期で漏れた日付を補うために 手動アップロード を使います。設定確認にも使えます。
- 自動化を開き、既存データをエクスポート の下で 手動アップロード を選びます。
- 開始 と 終了 の日付を設定し、エクスポートを開始 を選びます。
- Home Assistant で 開発者ツール → 状態 を開き、自動化の
hae.接頭辞を検索します。 - エンティティの値と更新時刻を確認します。
トラブルシューティング
- 認証エラー: トークンと
Authorization: Bearer ...ヘッダーを確認します。 - 接続失敗: ベース URL、ポート、ネットワークアクセス、証明書の信頼を確認します。
- 一部の測定値が欠ける: 選択した日、ソース、アクティビティログを確認します。実行は一部のエンティティを更新し、ほかが失敗することがあります。
自動化を開き アクティビティログを表示 で失敗したステップを確認します。サポートは ヘルプを得る を参照してください。