自動化概要ガイド

自動化により、手動操作なしで Apple Health データをさまざまな送信先へ自動的にエクスポートおよび同期できます。このガイドでは自動化機能の概要と、各自動化タイプの詳細ガイドへのリンクを説明します。

概要

自動化は、健康データを外部サービス、クラウドストレージ、その他の送信先へ自動的にエクスポートする設定済みワークフローです。設定後はバックグラウンドで自動実行できます。

メリット:

• データの自動バックアップと同期
• 手動操作が不要
• 同期頻度を設定可能
• 用途に応じた複数の自動化タイプ
• バックグラウンド動作（アプリを開いている必要はない）

ユースケース:

• クラウドへの自動バックアップ
• ホームオートメーションシステムとの連携
• カスタムアプリ向けの API 連携
• データ分析・可視化プラットフォーム
• 医療提供者との健康データの共有

制限事項:

• 健康データへのアクセス: iPhone がロックされている間、アプリは健康データにアクセスできません。自動化はデバイスがロック解除されているときにのみ実行されます。これは Apple が課す制限であり、回避できません。詳細情報
• バックグラウンド処理: iOS はバッテリー寿命のためバックグラウンド処理を制限します。自動化はバックグラウンド App の更新に依存し、次の場合はすぐに実行されないことがあります:
  • アプリのバックグラウンド App の更新がオフになっている
  • デバイスが低電力モードである
  • デバイスが長時間非アクティブだった
  • システムリソースが不足している
  • 複数のアプリがバックグラウンド実行時間を奪い合っている
• スケジュール: バックグラウンド処理に関連して、iOS は指定した時刻にアプリをバックグラウンドで実行することも許可しません。特定の同期間隔を設定しても、指定時刻に正確に実行される保証はありません。デバイスはロック解除されている必要があり、バックグラウンドでの実行タイミングは iOS が決定します。自動化は次の方法で手動トリガーすることもできます:
  • 自動化ウィジェット: ウィジェットアイコンをタップして自動化を実行
  • ショートカット — 自動化を実行: 自動化を実行アクションで設定済みの自動化を実行（ショートカットで自動化をスケジュールするを参照）
  • アプリ内で手動トリガー: Health Auto Export で該当の自動化を開き、手動エクスポートを実行
• フォアグラウンド同期: Health Auto Export をフォアグラウンドで開いている間、対象の自動化は定期的（約 60 秒ごと）に再実行される場合があります。フォアグラウンド利用中はデバイスがスリープしないため、同期を継続できます。フォアグラウンドのループは、デバイスが重大なサーマル状態に達したときのみ一時停止します。それ未満の発熱状態でもフォアグラウンド同期は続くことがあります。アプリがフォアグラウンドでないときは、上記のバックグラウンドスケジュールの制限が引き続き適用されます。

パフォーマンス

iOS は、非常に厳しいパフォーマンス制約のあるモバイルデバイスで短時間のタスク向けに最適化されていることに留意してください。バックグラウンドタスクは通常 30 秒以内に完了する必要があり、使用できるメモリにも制限があります。Health Auto Export は高い柔軟性とカスタマイズ性を提供するため、設定がアプリのパフォーマンスと結果にどう影響するかを理解することが重要です。

• 設定: 大量のデータを生成する自動化は、システムがプロセスを終了させ、バックグラウンドで自動化が実行されなくなる原因になることがあります。次の設定は大量のデータを生成する可能性があります:
  • すべての健康メトリクスをエクスポートするよう設定された自動化。
    • 推奨: Apple Health に保存されているデータがある健康メトリクスのみ、実際に使用するデータのみを選択してください。空のデータタイプでもパフォーマンスに影響します。選択した健康メトリクスを複数の自動化に分割することも検討してください。システムが処理しやすくなります。
  • 秒または分単位の時間グループ化を使用する自動化、またはデータ要約がオフの自動化。このような細かいクエリは実行に時間がかかり、システムの制限と衝突する可能性があります。
    • 推奨: 可能な限り詳細なデータが理想的に思えても、各メトリクスやデータタイプにそのレベルの詳細が必要か検討してください。設定の異なる複数の自動化を検討してください。
  • サイクリング、ランニング、ハイキングなどの屋外ワークアウトをルートデータ付きでエクスポートする場合、GPS と関連する健康メトリクスデータは大きなペイロードを生成する可能性があります。
• ペイロードサイズ: REST API エクスポートを使用する場合は特に、大きなペイロードがサーバーエラーの原因になることがあります。バックエンドが数百メガバイト規模のペイロードを処理できるよう設定されていることを確認してください。
• 同期頻度: ホーム画面に自動化ウィジェットを追加すると、バックグラウンドでの自動化実行がより確実になります（自動化のウィジェット設定を参照）。

利用可能な自動化タイプ

Health Auto Export は、特定の用途向けに設計された複数の自動化タイプをサポートしています:

REST API

HTTP POST リクエストを受け付ける任意の Web サービスに健康データを送信します。カスタムバックエンド、Webhook、サードパーティ API に最適です。

ガイド: REST API 自動化ガイド

Home Assistant

健康メトリクスを Home Assistant のセンサー状態として同期します。スマートホームの自動化に健康データを組み込むのに最適です。

ガイド: Home Assistant 自動化ガイド

MQTT

健康データを MQTT ブローカーに公開します。IoT プラットフォームや MQTT ベースのシステムに最適です。

ガイド: MQTT 自動化ガイド

Dropbox

健康データを Dropbox に自動バックアップします。ファイルはフォルダーに整理され、任意のデバイスからアクセスできます。

ガイド: Dropbox 自動化ガイド

Google Drive

健康データを Google ドライブに自動バックアップします。CSV は Google スプレッドシートに変換して表示できます。

ガイド: Google ドライブ自動化ガイド

iCloud Drive

健康データを iCloud ドライブに直接保存します。認証不要で簡単に設定できます。

ガイド: iCloud ドライブ自動化ガイド

カレンダー

健康データに基づいてカレンダーイベントを作成します。ワークアウト、健康のマイルストーンなどをカレンダーで確認できます。

ガイド: カレンダー自動化ガイド

最初の自動化を作成する

1. メインナビゲーションから自動エクスポート画面を開く
2. 「新しい自動化」をタップ
3. 自動化タイプを選択
4. 自動化固有の設定を構成（各ガイドを参照）
5. 共通設定を構成（データタイプ、同期間隔など）
6. 「更新」をタップして保存
7. 自動化を有効にする

自動化のバックアップと復元

Health Auto Export は、自動化の設定を iCloud ドライブにバックアップし、新しいデバイスやアプリ再インストール後に復元できます。これは、自動化がエクスポートする健康データとは別です。

• バックアップの保存場所: 自動化設定は iCloud ドライブの Auto Export/Automations フォルダーに JSON ファイルとして保存されます（ファイル App で確認できます）。
• バックアップのタイミング: 自動化を保存するたび（更新をタップするか、編集画面を離れるたび）に、その自動化は自動的にバックアップされます。
• オン/オフ: 自動化リストを開き、自動化設定に進み、iCloud ドライブにバックアップを使用します。デフォルトでオンです。オフにすると、iCloud ドライブの既存のバックアップファイルを削除するかどうか尋ねられます。いずれにしても、自動化はデバイスに残ります。

復元

自動エクスポートを開き、まだ自動化がなく iCloud ドライブにバックアップがある場合、iCloud ドライブから復元ボタンが表示されます。タップすると自動化が戻ります。

復元後に知っておくべきこと:

• アカウントを再接続: プライバシー保護のため、Dropbox や Google ドライブなどのサービスのサインイントークンはバックアップに含まれません。復元後、各自動化でそれらのサービスを再接続してください。
• 自動化を再有効化: 復元された自動化は無効の状態で始まり、古い設定で予期せず実行されることを防ぎます。それぞれを確認し、準備ができたら有効にしてください。
• 部分的な復元: 一部の自動化を復元できない場合（ファイルがまだダウンロードされていない、暗号化キーがまだ利用できない、より新しいバージョンのアプリで作成されたなど）、残りは復元され、スキップされたものが表示されます。

注: 自動化に入力したリクエストヘッダーや認証情報（MQTT パスワードなど）は、iCloud ドライブのバックアップファイルで暗号化されています。新しいデバイスでの復元には、アプリが復号できるよう iCloud キーチェーンが必要です。手動で共有/エクスポートしたファイルは暗号化されていないプレーン JSON のままです。

アクティビティログ

各自動化には、実行履歴用のアクティビティログがあります。

1. 自動化を開き、アクティビティログを表示をタップします。
2. イベントは実行ごとにグループ化されます（新しい実行が上）。実行を展開すると個別のイベントが表示されます。
3. 警告（例: 健康データのクエリが遅い）は、実行は完了したが一部のステップに想定より時間がかかったことを示します。エラーは、ステップが失敗したことを示します（アップロード、HealthKit の読み取り、認証など）。
4. クリア（ツールバー）は、その自動化のアクティビティ履歴のみを削除し、アプリ全体の診断ログは削除しません。
5. 共有（ツールバー）は、App イベントログ診断 ZIP の全体をエクスポートします。設定 → 詳細 → イベントログをエクスポートと同じバンドルです。App イベントログガイドを参照してください。

アクティビティログの遅いクエリ

• 健康データの取得に時間がかかると、アクティビティログに健康データのクエリが遅いという警告（エラーではない）が表示されることがあります。
• 実行を速くするには: 健康メトリクスを少なくする、日付範囲を短くする、データを要約をオンにする、時間のグループ化を大きくする（時間・日・週）。
• リアルタイム自動化は設計上、より細かいグループ化を使うため、遅いクエリの警告が出やすいことがあります。

エクスポート設定の警告

健康メトリクスの自動化（Home Assistant 以外）を構成すると、設定が遅くなる可能性がある場合、エクスポート設定の下にフッターが表示されることがあります:

• データを要約がオフ、または時間のグループ化が分または秒、かつ
• 10 個を超える健康メトリクスが選択されている

フッターでは、メトリクスを減らす、日付範囲を短くする、データを要約する、時間のグループ化を粗くするなどを提案し、このガイドへのリンクがあります。遅いクエリの警告はアクティビティログに別途表示され、実行後にクエリがしきい値を超えたときに現れます。

ベストプラクティス

1. 自動同期:

• デバイスを充電し、iPhone ミラーリングを使用する
  • 充電中は iOS がパフォーマンスをあまり制限しないため、データをより頻繁に同期できます
  • iPhone ミラーリングを使うと、デバイスはロック解除時と同様に動作します。Health Auto Export が健康データにアクセスし、自動化を実行できます

2. 同期頻度:

• データの鮮度とリソース使用量のバランスを取る
• 多くの用途では日次同期で十分
• リアルタイムが必要ならより頻繁に
• 要約データなら低頻度でよい

3. データの選択:

• 必要なメトリクスのみを選ぶ
• 処理時間とデータ量を削減できる
• メトリクスグループごとに別の自動化を検討する

4. テスト:

• 手動エクスポートを実行する
• 送信先にデータが届くことを確認する
• アクティビティログでエラーを確認する
• 初回の同期は注意深く監視する

5. 監視:

• アクティビティログを定期的に確認する
• 自動化のステータス表示を確認する
• 重要な自動化には通知を設定する
• 送信先でデータの受信を確認する

6. セキュリティ:

• 安全な認証方法を使う
• 認証情報を最新に保つ
• 利用可能なら HTTPS/TLS を使う
• プライバシー設定を確認する

7. パフォーマンス:

• 適切な時間のグループ化を使う
• クラウドストレージでは日付範囲の設定を検討する
• バッテリーとデータ使用量を監視する
• 遅いクエリの警告についてアクティビティログを確認する

8. バックアップ戦略:

• 冗長化のため複数の自動化タイプを使う
• クラウドストレージと API 連携を組み合わせる
• 可能ならローカルバックアップも保持する
• 復元手順をテストする

9. トラブルシューティング:

• まずアクティビティログを確認する
• ネットワーク接続を確認する
• 認証情報を確認する
• 個別の自動化ガイドで固有の問題を確認する

自動化ウィジェット

ホーム画面に「自動化」ウィジェットを追加すると:

• 自動化の状態を一目で確認できる
• 自動化を手動で実行できる
• バックグラウンドのアップロードを最適化できる

ヘルプを得る

特定の自動化タイプで困ったとき:

1. 該当する自動化ガイドを参照する
2. アクティビティログのエラーメッセージを確認する
3. トラブルシューティングの章を読む
4. 問題が続く場合はサポートに連絡する