Google Health API を使用して睡眠エクスペリエンスを開発する

Google Health API には、ユーザーの睡眠パターン(睡眠時間、睡眠の質、安静時の生理学的指標など)を追跡するデータ型が用意されています。これらの指標は、アプリが回復、睡眠衛生、長期的な健康傾向に関する分析情報を提供するのに役立ちます。

心拍変動(HRV)、血中酸素(SpO2)、呼吸数などの生理学的指標は、身体が安定した安静状態にある睡眠中に記録されます。これにより、API は、日中のストレス要因、身体活動、さまざまな環境条件の影響を受けることなく、ユーザーの自律神経と呼吸器の健康のベースラインをキャプチャできます。

これらのデータ型の違いを理解して、アプリケーションに適した指標を決定します。

サポートされるデータタイプ

この API は、睡眠を測定するための次のデータ型をサポートしています。

表: Google Health API の睡眠データタイプ
データ型 使用可能な
オペレーション
スコープ
1 日の心拍変動
dataType: daily-heart-rate-variability
filter parameter: daily_heart_rate_variability
レコードタイプ: 日単位

対応デバイス

list、reconcile .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
1 日の血中酸素ウェルネス
dataType: daily-oxygen-saturation
filter parameter: daily_oxygen_saturation
レコードタイプ: 日単位

対応デバイス

list、reconcile .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
1 日の呼吸数
dataType: daily-respiratory-rate
filter parameter: daily_respiratory_rate
レコードタイプ: 日単位

対応デバイス

list、reconcile .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
睡眠時の体温の 1 日の変動
dataType: daily-sleep-temperature-derivations
filter parameter: daily_sleep_temperature_derivations
レコードタイプ: 日単位

対応デバイス

list、reconcile .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
心拍変動
dataType: heart-rate-variability
filter parameter: heart_rate_variability
レコードタイプ: サンプル

対応デバイス

list、reconcile .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
血中酸素
dataType: oxygen-saturation
filter parameter: oxygen_saturation
レコードタイプ: サンプル
ストレージの解像度: 1 分

対応デバイス

list、reconcile .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
呼吸数の睡眠のまとめ
dataType: respiratory-rate-sleep-summary
filter parameter: respiratory_rate_sleep_summary
レコードタイプ: サンプル

対応デバイス

list、reconcile .health_metrics_and_measurements.readonly
.health_metrics_and_measurements.writeonly
睡眠
dataType: sleep
filter parameter: sleep
Record type(レコードタイプ): Session(セッション)

対応デバイス

list、get、reconcile、create、update、batchDelete .sleep.readonly
.sleep.writeonly

睡眠セッションと短い覚醒

睡眠セッション(Sleep)は、1 回の夜間の睡眠や昼寝など、個別の睡眠イベントを表します。これには、重複しない睡眠ステージの詳細な内訳と、短い覚醒として知られる短い覚醒移行間隔が含まれます。

  • 睡眠セッション(Sleep): 主な休息の連続したタイムラインを分割する個別の睡眠イベント(LIGHT、DEEP、REM、AWAKE ステージ間隔)を表します。
  • 短い覚醒(shortAwakenings): 休息中に発生する短い覚醒への移行または覚醒。標準の AWAKE ステージ間隔(重複しない連続した睡眠ステージの進行を分割する)とは異なり、短い覚醒は、周囲の睡眠ステージと重複する可能性がある個別のセグメントです。これにより、主な睡眠ステージの構造を乱すことなく、寝付けない状態や微小覚醒をきめ細かく可視化できます。
  • 夜間の覚醒: 夜間の覚醒(水を飲むために起きるなど)は、デバイス上のセンサー フュージョン(加速度計、ジャイロスコープ、歩数)によって識別されます。アプリは、type: "AWAKE"(CLASSIC と STAGES の両方の睡眠記録で使用)の間隔で stages をフィルタリングするか、outOfBedSegments を検査することで、夜間の覚醒を検出できます。

例

{
  "name": "users/user-id/dataTypes/sleep/dataPoints/data-point-id",
  "sleep": {
    "interval": {
      "startTime": "2026-04-20T22:30:00Z",
      "startUtcOffset": "-14400s",
      "endTime": "2026-04-21T06:30:00Z",
      "endUtcOffset": "-14400s"
    },
    "type": "STAGES",
    "stages": [
      {
        "startTime": "2026-04-20T22:30:00Z",
        "startUtcOffset": "-14400s",
        "endTime": "2026-04-20T23:45:00Z",
        "endUtcOffset": "-14400s",
        "type": "LIGHT"
      },
      {
        "startTime": "2026-04-20T23:45:00Z",
        "startUtcOffset": "-14400s",
        "endTime": "2026-04-21T01:15:00Z",
        "endUtcOffset": "-14400s",
        "type": "DEEP"
      }
    ],
    "shortAwakenings": [
      {
        "startTime": "2026-04-20T23:10:00Z",
        "startUtcOffset": "-14400s",
        "endTime": "2026-04-20T23:11:30Z",
        "endUtcOffset": "-14400s",
        "type": "AWAKE"
      }
    ],
    "summary": {
      "minutesInSleepPeriod": "480",
      "minutesAsleep": "455",
      "minutesAwake": "25",
      "minutesToFallAsleep": "15",
      "minutesAfterWakeUp": "10"
    }
  }
}

睡眠セッションを作成する

睡眠セッション エントリを作成するには、sleep データポイント エンドポイントに POST リクエストを送信します。レスポンスには、data-point-id を含む name フィールドが含まれます。これは、Update(Patch)リクエストまたはDelete リクエストで使用できます。

リクエスト

POST https://health.googleapis.com/v4/users/me/dataTypes/sleep/dataPoints
Authorization: Bearer access-token
Content-Type: application/json

{
  "sleep": {
    "interval": {
      "startTime": "2026-06-07T22:00:00Z",
      "startUtcOffset": "-14400s",
      "endTime": "2026-06-08T06:00:00Z",
      "endUtcOffset": "-14400s"
    },
    "type": "STAGES",
    "stages": [
      {
        "startTime": "2026-06-07T22:00:00Z",
        "startUtcOffset": "-14400s",
        "endTime": "2026-06-07T22:30:00Z",
        "endUtcOffset": "-14400s",
        "type": "LIGHT"
      },
      {
        "startTime": "2026-06-07T22:30:00Z",
        "startUtcOffset": "-14400s",
        "endTime": "2026-06-07T23:45:00Z",
        "endUtcOffset": "-14400s",
        "type": "DEEP"
      },
      {
        "startTime": "2026-06-07T23:45:00Z",
        "startUtcOffset": "-14400s",
        "endTime": "2026-06-08T02:15:00Z",
        "endUtcOffset": "-14400s",
        "type": "LIGHT"
      },
      {
        "startTime": "2026-06-08T02:15:00Z",
        "startUtcOffset": "-14400s",
        "endTime": "2026-06-08T02:45:00Z",
        "endUtcOffset": "-14400s",
        "type": "REM"
      },
      {
        "startTime": "2026-06-08T02:45:00Z",
        "startUtcOffset": "-14400s",
        "endTime": "2026-06-08T05:15:00Z",
        "endUtcOffset": "-14400s",
        "type": "LIGHT"
      },
      {
        "startTime": "2026-06-08T05:15:00Z",
        "startUtcOffset": "-14400s",
        "endTime": "2026-06-08T06:00:00Z",
        "endUtcOffset": "-14400s",
        "type": "REM"
      }
    ]
  }
}

レスポンス

{
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.devicesandservices.health.v4.DataPoint",
    "name": "users/user-id/dataTypes/sleep/dataPoints/data-point-id",
    "sleep": {
      "interval": {
        "startTime": "2026-06-07T22:00:00Z",
        "startUtcOffset": "-14400s",
        "endTime": "2026-06-08T06:00:00Z",
        "endUtcOffset": "-14400s"
      },
      "type": "STAGES",
      "stages": [
        {
          "startTime": "2026-06-07T22:00:00Z",
          "startUtcOffset": "-14400s",
          "endTime": "2026-06-07T22:30:00Z",
          "endUtcOffset": "-14400s",
          "type": "LIGHT"
        },
        {
          "startTime": "2026-06-07T22:30:00Z",
          "startUtcOffset": "-14400s",
          "endTime": "2026-06-07T23:45:00Z",
          "endUtcOffset": "-14400s",
          "type": "DEEP"
        },
        {
          "startTime": "2026-06-07T23:45:00Z",
          "startUtcOffset": "-14400s",
          "endTime": "2026-06-08T02:15:00Z",
          "endUtcOffset": "-14400s",
          "type": "LIGHT"
        },
        {
          "startTime": "2026-06-08T02:15:00Z",
          "startUtcOffset": "-14400s",
          "endTime": "2026-06-08T02:45:00Z",
          "endUtcOffset": "-14400s",
          "type": "REM"
        },
        {
          "startTime": "2026-06-08T02:45:00Z",
          "startUtcOffset": "-14400s",
          "endTime": "2026-06-08T05:15:00Z",
          "endUtcOffset": "-14400s",
          "type": "LIGHT"
        },
        {
          "startTime": "2026-06-08T05:15:00Z",
          "startUtcOffset": "-14400s",
          "endTime": "2026-06-08T06:00:00Z",
          "endUtcOffset": "-14400s",
          "type": "REM"
        }
      ]
    }
  }
}

睡眠効率と睡眠潜時の指標

この API は、睡眠ステージと生理学的指標に加えて、睡眠の質と睡眠開始を定量化する主要な指標を提供します。睡眠効率と睡眠潜時は、ユーザーがベッドにいる合計時間に対してどれだけ効果的に休息しているかを示す標準的な臨床指標であり、睡眠衛生と休息に関する分析情報を提供します。

睡眠効率スコア

睡眠効率は、寝床で過ごした合計時間に対する睡眠時間の割合として定義される標準的な指標です。API は、次の式を使用して睡眠効率を計算します。

Sleep Efficiency Score = round( (Total Minutes Asleep / Total Minutes In Bed) * 100 )

効率スコアは、睡眠レベル(ステージ)の分割の直前に計算されます。API レスポンス(summary.minutesAsleep フィールド)で返される合計睡眠時間は、睡眠レベルの計算後の最終結果を反映しています。

ユーザーまたは研究者が睡眠記録の開始時間または終了時間を手動で変更すると、API は睡眠効率スコアを再計算し、新しい就寝時間と起床時間の境界内で記録されたセンサーデータに従ってステージ パーティションを調整します。

入眠潜時

入眠潜時は、ユーザーが就寝しようとしたとき(「就寝」または「消灯」時間の開始)から入眠するまでの経過時間を測定します。

自動的に生成されたログ(metadata.manuallyEdited が false)の場合、入眠の明示的な意図がログに記録されていないため、summary.minutesToFallAsleep はデフォルトで "0" になります。就寝開始時間が手動で記録または編集された場合(metadata.manuallyEdited が true)、API は summary.minutesToFallAsleep と summary.minutesAfterWakeUp を計算して入力します。

調査と手動ロギングのガイダンス

参加者が就寝の開始時刻と終了時刻を手動で記録または調整した場合:

  1. 就寝境界を更新すると、睡眠の interval(および summary.minutesInSleepPeriod)が変更されます。
  2. 睡眠レベルと睡眠ステージのパーティションは、新しいウィンドウ内でセンサーデータを評価するように自動調整されます。
  3. 睡眠効率スコア、summary.minutesToFallAsleep、summary.minutesAfterWakeUp は、更新された時間枠に基づいて再導出されます。

毎日の睡眠時皮膚温の変動

1 日の睡眠時皮膚温の導出では、睡眠中のユーザーの皮膚温の変動をベースラインと比較して測定します。このデータは通常、主な睡眠セッションの後に 1 日 1 回報告されます。

呼吸数

呼吸数は、1 分あたりの呼吸回数を測定したものです。睡眠中は、睡眠の質や潜在的な睡眠障害をモニタリングするための重要な指標となります。この API は、呼吸数のサンプル(respiratory-rate)、1 日の概要(daily-respiratory-rate)、セッション レベルの睡眠のまとめ(respiratory-rate-sleep-summary)をサポートしています。

心拍変動(HRV)

HRV は、各心拍間の時間間隔の変動を測定します。これは自律神経系の状態を示す重要な指標です。睡眠中の HRV が高い場合は、一般的に回復と準備が良好であることを示し、HRV が低い場合は、ストレスやオーバートレーニングを示している可能性があります。この API は、HRV のサンプル(heart-rate-variability)と 1 日の概要(daily-heart-rate-variability)をサポートしています。

血中酸素

血中酸素飽和度(SpO2)は、血液中の総ヘモグロビンに対する酸素飽和ヘモグロビンの割合を表します。睡眠中の SpO2 をモニタリングすることで、呼吸障害の可能性を検出し、ユーザーが一晩中適切な酸素レベルを維持しているかどうかを確認できます。この API は、サンプル SpO2(oxygen-saturation)と 1 日の概要(daily-oxygen-saturation)をサポートしています。

分単位の oxygen-saturation をクエリすると、Google Health API は検証済みのデータポイントのみを返し、腕の動き、手首の緩み、センサーの信頼性の低さ(50% 未満)によって生じた無効な測定値や、モーション ノイズに隣接する測定値を除外します。無効な分は除外されるため、分単位のカバレッジがまばらになり、タイムスタンプにギャップが生じることがあります。oxygen-saturation と daily-oxygen-saturation の両方が、同じ検証済みの測定値に依存しています。検証基準の詳細については、分単位の SpO2 フィルタリングとデータの有効性をご覧ください。

睡眠の質と回復を総合的に把握

各指標は特定の分析情報を提供しますが、これらは深く関連しており、ユーザーの回復を総合的に把握できます。睡眠ステージ(浅い睡眠、深い睡眠、レム睡眠)は休息の構造的な基盤を提供し、HRV や SpO2 などの生理学的指標は、身体がその休息にどのように反応しているかを示します。たとえば、最適な深い睡眠を伴う質の高い睡眠セッションは、多くの場合、HRV の向上と相関しており、自律神経系の効果的な回復を示しています。

これらを呼吸数と睡眠温度の導出と組み合わせることで、アプリは潜在的な障害を特定できます。呼吸数の急激な上昇や睡眠中の体温の変動は、ユーザーが回復段階に費やした時間が短かった理由を説明するのに役立ちます。これらのデータタイプを組み合わせて分析することで、デベロッパーは睡眠衛生と長期的な健康傾向を包括的に評価できます。

ガイドライン

睡眠指標をアプリに統合する際は、次のガイドラインに沿ってください。

  • セッションの詳細: ユーザーの睡眠ステージ(浅い睡眠、深い睡眠、レム睡眠、覚醒)と短い覚醒を表示するには、sleep データタイプをクエリします。
  • 夜間の覚醒: 未加工のセンサー ストリームを使用せずに夜間の覚醒イベントを追跡するには、sleep ステージの間隔を調べて、type: "AWAKE" を含む項目をフィルタします(STAGES と CLASSIC の両方の睡眠記録)。または、outOfBedSegments を調べます。
  • レイテンシと効率: summary.minutesToFallAsleep と睡眠効率の式を使用して、睡眠レイテンシを分析します。summary.minutesToFallAsleep は、睡眠記録が手動で編集された場合(metadata.manuallyEdited が true)または明示的に記録された場合に入力されます。
  • 生理学的モニタリング: 高度な健康モニタリングを行うには、睡眠セッションのデータと、respiratory-rate-sleep-summary、daily-sleep-temperature-derivations、daily-heart-rate-variability、daily-oxygen-saturation などの生理学的指標や回復指標を組み合わせます。
  • 調整: reconcile オペレーションを使用して、異なるデバイス(ウェアラブルとマットレス センサーなど)からの重複する睡眠記録を 1 つの「メイン」睡眠記録に統合します。

深い睡眠の合計時間を計算する

特定の夜にユーザーが回復効果のある深い睡眠ステージで過ごした合計時間を計算するには:

  1. 指定した期間の sleep データ型をクエリします。
  2. ステージリストを反復処理し、type が DEEP である間隔を特定します。
  3. 各深い睡眠の間隔の長さ(終了時刻 - 開始時刻)を計算し、合計します。

結果の合計は、そのセッションの深い睡眠の物理的な合計時間になります。