Разрабатывайте приложения для улучшения качества сна с помощью API Google Health.

API Google Health предоставляет типы данных, отслеживающие режим сна пользователя, включая продолжительность, качество и физиологические показатели во время отдыха. Эти показатели помогают приложениям получать информацию о восстановлении, гигиене сна и долгосрочных тенденциях в состоянии здоровья.

Физиологические показатели, такие как вариабельность сердечного ритма (ВСР), насыщение крови кислородом (SpO2) и частота дыхания, регистрируются именно во время сна, поскольку организм находится в стабильном состоянии покоя. Это позволяет API получать базовые данные о состоянии вегетативной нервной системы и дыхательной системы пользователя без влияния дневных стрессовых факторов, физической активности или изменяющихся условий окружающей среды.

Чтобы определить, какие метрики подходят для вашего приложения, необходимо понимать различия между этими типами данных.

Поддерживаемые типы данных

API поддерживает следующие типы данных для измерения сна:

Таблица: Типы данных о сне из Google Health API

Тип данных dataType параметр filter	Доступный операции	Объем
Суточная вариабельность сердечного ритма daily-heart-rate-variability daily_heart_rate_variability Тип записи: Ежедневная Поддержка вебхуков Руководство по жизненно важным показателям Руководство по сну Совместимые устройства Фитнес-браслет Fitbit Air Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Фитнес-браслет Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Пиксельные часы Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4	список, согласовать	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Суточная сатурация кислорода daily-oxygen-saturation daily_oxygen_saturation Тип записи: Ежедневная Поддержка вебхуков Руководство по жизненно важным показателям Руководство по сну Совместимые устройства Фитнес-браслет Fitbit Air Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Фитнес-браслет Fitbit Inspire 3 Fitbit Ionic Fitbit Luxe Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4	список, согласовать	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Суточная частота дыхания daily-respiratory-rate daily_respiratory_rate Тип записи: Ежедневная Поддержка вебхуков Руководство по жизненно важным показателям Руководство по сну Совместимые устройства Фитнес-браслет Fitbit Air Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Фитнес-браслет Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Пиксельные часы Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4	список, согласовать	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Ежедневные измерения температуры во время сна daily-sleep-temperature-derivations daily_sleep_temperature_derivations Тип записи: Ежедневная Поддержка вебхуков Руководство по жизненно важным показателям Руководство по сну Совместимые устройства Фитнес-браслет Fitbit Air Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Фитнес-браслет Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4	список, согласовать	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Вариабельность сердечного ритма heart-rate-variability heart_rate_variability Тип записи: Образец Поддержка вебхуков Руководство по жизненно важным показателям Руководство по сну Совместимые устройства Фитнес-браслет Fitbit Air Fitbit Alta Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Flex 2 Fitbit Inspire Fitbit Inspire 2 Фитнес-браслет Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Fitbit MobileTrack Пиксельные часы Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	список, согласовать	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Насыщение кислородом oxygen-saturation oxygen_saturation Тип записи: Образец Руководство по жизненно важным показателям Руководство по сну Совместимые устройства Фитнес-браслет Fitbit Air Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Фитнес-браслет Fitbit Inspire 3 Fitbit Ionic Fitbit Luxe Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4	список, согласовать	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Сводка по частоте дыхания во сне respiratory-rate-sleep-summary respiratory_rate_sleep_summary Тип записи: Образец Поддержка вебхуков Руководство по жизненно важным показателям Руководство по сну Совместимые устройства Фитнес-браслет Fitbit Air Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Фитнес-браслет Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Пиксельные часы Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4	список, согласовать	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Спать sleep sleep Тип записи: Сессия Поддержка веб-хуков Руководство по сну Совместимые устройства Фитнес-браслет Fitbit Air Fitbit Alta Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Flex 2 Fitbit Inspire Fitbit Inspire 2 Фитнес-браслет Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Пиксельные часы Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	список, получить, согласовать, создать, обновить, пакетное удаление	.sleep.readonly .sleep.writeonly

Сеансы сна и короткие пробуждения

Сеанс сна ( Sleep ) представляет собой отдельное событие сна, такое как один ночной сон или дневной сон. Он включает в себя подробное описание непересекающихся стадий сна, а также короткие переходные интервалы между периодами бодрствования, известные как короткие пробуждения.

• Сеанс сна ( Sleep ) : Представляет собой дискретное событие сна (интервалы LIGHT , DEEP , REM , фазы AWAKE ), которое разделяет непрерывную временную шкалу основного отдыха.
• Короткие пробуждения ( shortAwakenings ) : Кратковременные переходы в состояние бодрствования или пробуждения, происходящие во время отдыха. В отличие от стандартных интервалов стадии AWAKE (которые делят непересекающуюся последовательность стадий сна), короткие пробуждения представляют собой отдельные сегменты, которые могут перекрываться с окружающими стадиями сна. Они обеспечивают детальное наблюдение за беспокойством и микропробуждениями, не нарушая основную структуру стадий сна.

Пример

{
  "name": "sleeps/12345",
  "startTime": "2026-04-20T22:30:00Z",
  "endTime": "2026-04-21T06:30:00Z",
  "sleepType": "STAGES",
  "sleepStages": [
    {
      "startTime": "2026-04-20T22:30:00Z",
      "endTime": "2026-04-20T23:45:00Z",
      "type": "LIGHT"
    },
    {
      "startTime": "2026-04-20T23:45:00Z",
      "endTime": "2026-04-21T01:15:00Z",
      "type": "DEEP"
    }
  ],
  "shortAwakenings": [
    {
      "startTime": "2026-04-20T23:10:00Z",
      "endTime": "2026-04-20T23:11:30Z",
      "type": "AWAKE"
    }
  ]
}

Ежедневные измерения температуры во время сна

Ежедневные измерения температуры во время сна показывают изменение температуры кожи пользователя во время сна по сравнению с исходным уровнем. Эти данные обычно предоставляются один раз в день после продолжительного сна.

Частота дыхания

Частота дыхания измеряет количество вдохов и выдохов пользователя в минуту. Во время сна это ключевой показатель для мониторинга качества сна и потенциальных нарушений. API поддерживает пример частоты дыхания ( respiratory-rate ), ежедневные сводки ( daily-respiratory-rate ) и сводки сна на уровне сессии ( respiratory-rate-sleep-summary ).

Вариабельность сердечного ритма (ВСР)

Вариабельность сердечного ритма (ВСР) измеряет разницу во времени между каждым сердечным сокращением. Это ключевой показатель состояния вегетативной нервной системы; высокая ВСР во время сна, как правило, свидетельствует о лучшем восстановлении и готовности, в то время как низкая ВСР может указывать на стресс или перетренировку. API поддерживает примеры ВСР ( heart-rate-variability ) и ежедневные сводки ( daily-heart-rate-variability ).

Насыщение кислородом (SpO2)

SpO2 представляет собой процент насыщенного кислородом гемоглобина относительно общего количества гемоглобина в крови. Мониторинг SpO2 во время сна имеет решающее значение для выявления потенциальных нарушений дыхания и обеспечения поддержания пользователем адекватного уровня кислорода в течение всей ночи. API поддерживает выборочные значения SpO2 ( oxygen-saturation ) и ежедневные сводки ( daily-oxygen-saturation ).

Целостный взгляд на здоровье сна и восстановление после него.

Хотя каждый показатель дает специфические сведения, они тесно взаимосвязаны и вместе дают целостное представление о восстановлении пользователя. Стадии сна (легкий, глубокий, REM) обеспечивают структурную основу отдыха, в то время как физиологические маркеры, такие как вариабельность сердечного ритма (ВСР) и насыщение крови кислородом (SpO2), указывают на то, как организм физически реагирует на этот отдых. Например, качественный сон с оптимальным уровнем глубокого сна часто коррелирует с более высокой ВСР, что свидетельствует об эффективном восстановлении вегетативной нервной системы.

Сочетание этих данных с показателями частоты дыхания и температуры во время сна позволяет приложениям выявлять потенциальные нарушения. Внезапный скачок частоты дыхания или отклонение температуры во время сна могут объяснить, почему пользователь мог проводить меньше времени в восстановительных фазах. Анализируя эти типы данных в совокупности, разработчики могут обеспечить всестороннюю оценку гигиены сна и долгосрочных тенденций в состоянии здоровья.

Руководящие принципы

При интеграции показателей сна в ваше приложение следуйте этим рекомендациям:

• Детали сессии : Чтобы отобразить стадии сна пользователя (легкий сон, глубокий сон, REM-сон, бодрствование) и короткие периоды пробуждения, выполните запрос к типу данных sleep .
• Физиологический мониторинг : Для расширенного мониторинга состояния здоровья объедините данные о сеансах сна с физиологическими показателями и показателями восстановления, такими как respiratory-rate-sleep-summary , daily-sleep-temperature-derivations , daily-heart-rate-variability и daily-oxygen-saturation .
• Сверка : Используйте операцию reconcile , чтобы убедиться, что совпадающие записи о сне с разных устройств (например, носимого устройства и датчика матраса) объединены в единую «основную» запись о сне.

Рассчитайте общее время, проведенное в фазе глубокого сна.

Чтобы рассчитать общее время, которое пользователь провел в стадии глубокого восстановительного сна за определенную ночь:

1. Выполните запрос типа данных sleep за указанный временной диапазон.
2. Пройдитесь по списку этапов и определите интервалы, где stageType имеет значение DEEP .
3. Рассчитайте продолжительность (время окончания - время начала) каждого интервала глубокого сна и сложите полученные значения.

Полученная сумма показывает общую физическую продолжительность глубокого сна за данный сеанс.