自動化
設定した送信先へ Apple Health データをエクスポートします。バックグラウンド制限、リマインダー、共有設定に対応します。
最終更新: 2026年10月31日
自動化は、設定した送信先へ Apple Health データをエクスポートします。自動実行は、Apple のヘルスデータアクセスとバックグラウンド制限に依存します。
自動化の作成または編集
- iPhone では エクスポート → 自動化 を開きます。iPad ではサイドバーの 自動化 を開きます。
- 新規自動化 を選ぶか、既存の自動化を開きます。
- 自動化名を入力し、送信先を選び、下のガイドに従って設定を完了します。
- 必要なデータとエクスポート設定を選び、有効 をオンにして 更新 で保存します。
未完了の自動化に戻って設定を続けることができます。
利用できる自動化の種類
| 送信先 | 内容 |
|---|---|
| REST API | HTTP エンドポイントへエクスポートを送信 |
| Home Assistant | ヘルス指標をエンティティの状態として公開 |
| MQTT | ブローカーのトピックへ JSON を公開 |
| Dropbox | エクスポートファイルを Dropbox に保存 |
| Google Drive | ファイルを保存(任意で CSV を Sheets に変換) |
| iCloud Drive | エクスポートファイルを iCloud Drive に保存 |
| カレンダー | カレンダーイベントを作成または更新 |
| メール | エクスポートをメール添付で送信 |
制限事項
- ヘルスデータへのアクセス: iPhone がロックされている間、アプリはヘルスデータにアクセスできません。自動化はデバイスのロックが解除されているときのみ実行されます。これは Apple が課す制限であり、回避できません。詳細情報
- バックグラウンド処理: iOS はバッテリー寿命のためバックグラウンド処理を制限します。自動化はバックグラウンド App の更新に依存し、次の場合はすぐ実行されないことがあります:
- アプリのバックグラウンド App の更新がオフになっている
- デバイスが低電力モードである
- デバイスが長時間非アクティブだった
- システムリソースが不足している
- 複数のアプリがバックグラウンド実行時間を奪い合っている
スケジュール
iOS は指定時刻のバックグラウンド実行を保証しません。選んだ時刻に自動化を起動するには、ショートカットで自動化をスケジュールする を参照してください。アクションがヘルスデータを読み取るとき、デバイスはロック解除されている必要があります。
同期間隔
15 分ごと のように数値と時間単位を選び、希望するバックグラウンド同期間隔を設定します。この間隔でアプリが開く、または実行されることは保証されません。 バックグラウンド実行が利用できるタイミングは iOS が決定します。
アプリを開く
自動化と Mac へ同期は、Health Auto Export が開いている間に実行されます。
手動トリガー
次の方法で実行を開始できます:
- 自動化ウィジェット: ホーム画面ウィジェットのクラウドボタンをタップします。自動化ウィジェット を参照してください。
- ショートカット: 自動化を実行 で設定済みの自動化を起動します。ショートカットの設定 を参照してください。
- アプリ内: 既存データをエクスポート の下で 手動アップロード を選び、開始 と 終了 の日付を設定してから エクスポートを開始 を選びます。自動化の開始時に履歴データをエクスポートする、自動同期で漏れた日付を補う、または設定を確認するために使います。
スケジュールリマインダー
各自動化は、任意でデバイスのロック解除と Health Auto Export の起動を促せます。リマインダーを有効にする をオンにし、リマインダーの頻度 を 毎時、毎日、または 選択した曜日 に設定します。毎時リマインダーは 毎時の分 を使い、毎日および選択曜日は リマインダー時刻 を使います。リマインダーは自動化が実行されたことを意味せず、バックグラウンド同期が成功したあとも表示されることがあります。
- リマインダーの変更は自動化の保存後に有効になります。エディタには 保存後の次回リマインダー が表示されます。
- リマインダーをタップすると自動化が開きます。
- 開いて同期 は通知上のアクションです。アプリを開き、その自動化をすぐ実行します。自動化は有効である必要があります。
- 自動化が削除・無効、すでに実行中、または現在のアクセスでは実行できない場合、アプリは自動化画面に戻ります。
- リマインダーには通知の許可が必要です。通知アクセス に現在の状態が表示されます。通知が拒否されている場合は 通知設定を開く を使います。
共通のエクスポート設定
データの選択
データタイプ を選び、含めるヘルス指標、ワークアウトの種類、または症状を選択します。利用できるデータタイプと形式は送信先によって異なります。対象範囲は サポートされるデータ を参照してください。
ヘルス指標については、各自動化に独自の ソース設定 があります。
ワークアウトでは、ワークアウト指標を含める で心拍数や歩数などの選択した測定値を追加します。ルートデータを含める で利用可能なルートをワークアウトデータに含めます。フィールドの可用性およびワークアウトの時間グループ化は ワークアウト形式リファレンス を参照してください。
エクスポート形式とバージョン
- JSON は連携向けに構造化データを保持します。
- CSV は表計算に適しています。
- Markdown は読みやすいメモと表を作成します。
Home Assistant と MQTT は JSON を使い、カレンダーはファイルではなくイベントを作成します。Google スプレッドシートへの変換は Google Drive の CSV エクスポートにのみ適用されます。
現在のエクスポート構造には バージョン 2 を使い、既存のワークフローが要求する場合は バージョン 1 を選びます。形式の詳細は JSON と Markdown を参照してください。
日付範囲
Dropbox、Google Drive、iCloud Drive、カレンダーはデータを 日、週、月、または 年 で整理します。選択した各期間には、最終秒を含め、その終わりまでの測定値が含まれます。
REST API、MQTT、メールでは次を選べます:
| 選択 | 含まれる期間 |
|---|---|
| デフォルト | 前日と、実行時刻までの本日 |
| 前回の同期以降 | 前回の同期から実行時刻まで |
| 今日 | 実行時刻までの本日 |
| 昨日 | 前日 |
| 過去 7 日 | 直前の 7 全日 |
Home Assistant では デフォルト、今日、昨日 を選べます。
データの要約と時間グループ化
JSON のヘルス指標エクスポートでは、データを要約 が選択した 時間グループ化 に測定値をまとめます。個別の測定値が必要な場合はオフにします。CSV の自動化エクスポートは要約データを使います。利用できる時間グループは送信先と日付範囲によって異なります。
指標ごとの平均、合計、日次要約は ヘルス指標 を参照してください。
実行通知
キャッシュ更新時に通知 はデータの準備完了を知らせ、実行時に通知 は送信先での成功を知らせます。これらはアプリを開くよう促す スケジュールリマインダー とは別です。
自動化の状態を確認する
自動化の アクティビティログを表示 を開き、実行を確認します。自動化の実行中にキャンセルする場合は、エクスポートまたは自動化画面で 停止 を選び、確認します。
パフォーマンス
大きな日付範囲、多数の選択指標、詳細なワークアウトルート、分単位または秒単位の測定値は時間がかかり、バックグラウンド実行に使える時間やリソースを超えることがあります。
- 必要なデータだけを選びます。
- より短い日付範囲、またはより粗い時間グループ化でエクスポートを小さくします。
- 大きなエクスポートは必要に応じて複数の自動化に分けます。
- 大きな REST ペイロードでは バッチリクエスト を検討してください。
自動化のバックアップと復元
Health Auto Export は自動化の 設定 を iCloud Drive にバックアップし、新しいデバイスや再インストール後に復元できます。これは自動化がエクスポートするヘルスデータとは別です。
- バックアップの場所: 自動化設定は JSON ファイルとして iCloud Drive の Auto Export/Automations フォルダに保存されます(ファイルアプリで確認できます)。
- バックアップのタイミング: 自動化を保存するたび(更新 をタップするか、編集画面を離れるとき)、その自動化が自動的にバックアップされます。
- オン/オフ: 自動化一覧を開き 自動化設定 へ進み、iCloud Drive にバックアップ を使います。デフォルトはオンです。オフにすると、既存のバックアップファイルを iCloud Drive から削除するか確認されます。どちらを選んでも、デバイス上の自動化はそのまま残ります。
復元
自動化 を開き、まだ自動化がなく iCloud Drive にバックアップがある場合、iCloud Drive から復元 ボタンが表示されます。タップすると自動化が戻ります。
復元後に知っておくこと:
- アカウントの再接続: プライバシーのため、Dropbox や Google Drive などのサインイントークンはバックアップに 含まれません。復元後、各自動化でそれらのサービスに再接続してください。
- 自動化の再有効化: 復元された自動化は、古い設定のまま予期せず実行されないよう 無効 で始まります。内容を確認し、準備ができたら有効にします。
- 部分的な復元: 一部の自動化を復元できない場合(ファイルがまだダウンロードされていない、暗号化キーがまだ利用できない、新しいバージョンのアプリで作成されたなど)、残りの自動化は復元され、スキップされたものが表示されます。
注: 自動化に入力したリクエストヘッダーや認証情報(MQTT パスワードなど)は、iCloud Drive のバックアップファイル内で 暗号化 されます。新しいデバイスで復元するには、復号のために iCloud キーチェーン が必要です。
アクティビティログ
自動化を開き アクティビティログを表示 を選びます。実行を展開してイベントを確認します。
- 警告 はデータ取得の遅延など、潜在的な問題を示します。実行全体が成功したことの確認ではありません。
- エラー はデータ読み取り、認証、アップロードなど、失敗したステップを示します。
- クリア はその自動化のアクティビティ履歴を削除します。
- 共有 はサポート向けにアプリ全体の診断情報をエクスポートします。アプリイベントログ を参照してください。
アクティビティログの遅いクエリ
実行がヘルスデータの遅いクエリを報告する場合は、指標を減らし、日付範囲を短くし、データを要約 をオンにしてより粗い 時間グループ化 を使います。
自動化ウィジェット
自動化ウィジェット を追加し、ホーム画面から状態を確認したり、有効な自動化を起動したりできます。バックグラウンド更新の機会は iOS が制御します。
ヘルプを得る
まずアクティビティログと各送信先のトラブルシューティングを確認してください。それでも必要な場合は ヘルプを得る を参照してください。