Apple Healthの書き出しでデータが欠ける場合の対処法

Apple HealthやHealth Connectの書き出しでデータが欠ける場合は、まず読み取りの問題とファイル保存の問題を分けて確認します。データがないことは、測定値がゼロであることを意味しません。

確認できる1日から始める

1. Apple HealthまたはHealth Connectで、記録された値と日付を確認します。時計や記録元アプリの同期が終わるまで待ちます。
2. Health.mdで有効なプロファイル、指標、期間、形式、保存先を確認します。完了した1日の、対応する指標1つから始めます。
3. スマートフォンのロックを解除してHealth.mdを開き、利用できる場合はプレビューを確認します。その後書き出し、実際の結果と保存先を確認します。プレビューだけでは保存の成功は確認できません。

iPhoneで初めて書き出す手順またはAndroidの設定を参照してください。

記録元にはデータがあるのに書き出しが空

iPhoneでは、Apple HealthでHealth.mdに許可したカテゴリを確認します。HealthKitは読み取り権限が拒否されたかどうかをアプリに通知しません。空の結果だけでは、アクセス制限と該当する記録がない状態を区別できません。権限要求の成功も、すべての読み取りカテゴリの許可を意味しません。Appleの権限の説明を参照してください。

Androidでは、記録元アプリが実際にHealth Connectへ記録を書き込み、Health.mdが対応する種類を読み取れることを確認します。別のアプリ内だけにあるデータは書き出せない場合があります。Googleの確認手順を参照してください。

同期や権限変更後は、指標と日付を再確認します。欠けた値をゼロで置き換えないでください。

構造化された結果の complete_empty は、未対応・部分的・スキップ・失敗の出力と区別してください。測定値がゼロであることや、読み取り権限の判断を示すものではありません。

「今日」に昨夜の睡眠がない

夜の開始日（初期設定）: Health.mdはAppleとAndroidで、現地時間の正午から翌正午までを睡眠の日記期間に使います。火曜の朝は**昨日（月曜）**を選びます。火曜の午前0時を過ぎてから入眠した場合も同じです。睡眠と活動の両方なら月曜と火曜を書き出します。同期が遅れた場合は日記の日付を再実行してください。日付の例を参照してください。 朝の終了日: 起床した日付を書き出します。月曜の夜の睡眠なら火曜です。どちらの設定も書き出しのタイムゾーンを使用します。

プレビューにはデータがあるのにフォルダが空

iPhoneでは、有効なプロファイルの保存先がローカルフォルダ、Connected Mac、API Endpointのどれかを確認します。ファイルの場合はフォルダ、サブフォルダ、ファイル名と、書き込み・スキップ・失敗の結果を確認します。スキップは選択した書き込み方法による場合があります。利用できないフォルダを選び直し、ファイルプロバイダを確認してから再試行します。フォルダと保管庫およびプロファイルを参照してください。

CSVに合計しかなく、期待した測定記録がない

iPhoneのSummaryとDetailed Time-Seriesは詳細度が異なります。期間を広げる前にData Detailと指標を確認します。メタデータは健康の測定値ではありません。単位を保持し、日別合計と元の記録を区別してください。Lossless Health Recordsには別の取得状態があり、要約だけでは完全な取得を証明できません。形式とカバレッジの仕様を参照してください。

予約した書き出しが届かない

iOSのバックグラウンド処理とAndroid WorkManagerの時刻は目標であり、実行や配信の保証ではありません。ロックを解除してHealth.mdを開き、再実行する前に履歴と保留中の復旧を確認します。通知だけでは保存成功の証明になりません。iPhoneの予約と復旧またはAndroidの自動化を参照してください。

CLIタイムアウト

タイムアウトは受理済みジョブをキャンセルしません。

healthmd status --job JOB_UUID
healthmd resume JOB_UUID --timeout 300

完全性を主張する前に状態、欠落日、範囲、next_cursor、バージョン、制限を確認します。--allow-partialは終了方針だけを変えます。

健康記録を共有せずに問い合わせる

アプリとOSのバージョン、プラットフォーム、形式、空のデータ・スキップ・保存失敗のどれかを伝えてください。共有前に画像やログの個人情報を伏せてください。健康の値、移動経路、臨床文書、トークン、ペアリングコード、非公開のパスは公開しないでください。

ジョブ再開とキャンセル。バージョン互換性。