Google Health API предоставляет типы данных, которые отслеживают характер сна пользователя, включая продолжительность, качество и физиологические показатели во время отдыха. Эти показатели помогают приложениям предоставлять статистику по восстановлению, гигиене сна и долгосрочным тенденциям в отношении здоровья.
Физиологические показатели, такие как вариабельность сердечного ритма (ВСР), уровень кислорода в крови (SpO2) и частота дыхания, регистрируются именно во время сна, поскольку тело находится в стабильном состоянии покоя. Это позволяет API зафиксировать базовые показатели вегетативной и дыхательной систем без влияния дневных стрессоров, физической активности или меняющихся условий окружающей среды.
Изучите различия между этими типами данных, чтобы определить, какие показатели подходят для вашего приложения.
Поддерживаемые типы данных
API поддерживает следующие типы данных для отслеживания сна:
| Тип данных | Доступные операции |
Область действия |
|---|---|---|
|
Ежедневная вариабельность сердечного ритма
dataType:
daily-heart-rate-variabilityfilter parameter: daily_heart_rate_variability
Тип записи: ежедневно.
Совместимые устройства
|
список, сверка | .health_metrics_and_measurements.readonly.health_metrics_and_measurements.writeonly |
|
Ежедневный уровень кислорода в крови
dataType:
daily-oxygen-saturationfilter parameter: daily_oxygen_saturation
Тип записи: ежедневно.
Совместимые устройства
|
список, сверка | .health_metrics_and_measurements.readonly.health_metrics_and_measurements.writeonly |
|
Ежедневная частота дыхания
dataType:
daily-respiratory-ratefilter parameter: daily_respiratory_rate
Тип записи: ежедневно.
Совместимые устройства
|
список, сверка | .health_metrics_and_measurements.readonly.health_metrics_and_measurements.writeonly |
|
Ежедневные колебания температуры во время сна
dataType:
daily-sleep-temperature-derivationsfilter parameter: daily_sleep_temperature_derivations
Тип записи: ежедневно.
Поддержка вебхуков
Руководство по показателям здоровья
Руководство по сну
Руководство по температуре кожи
Совместимые устройства
|
список, сверка | .health_metrics_and_measurements.readonly.health_metrics_and_measurements.writeonly |
|
Вариабельность сердечного ритма
dataType:
heart-rate-variabilityfilter parameter: heart_rate_variability
Тип записи: Sample.
Совместимые устройства
|
список, сверка | .health_metrics_and_measurements.readonly.health_metrics_and_measurements.writeonly |
|
Уровень кислорода в крови
dataType:
oxygen-saturationfilter parameter: oxygen_saturation
Тип записи: Sample.
Разрешение хранилища: 1 минута.
Совместимые устройства
|
список, сверка | .health_metrics_and_measurements.readonly.health_metrics_and_measurements.writeonly |
|
Отчет о частоте дыхания во время сна
dataType:
respiratory-rate-sleep-summaryfilter parameter: respiratory_rate_sleep_summary
Тип записи: Sample.
Совместимые устройства
|
список, сверка | .health_metrics_and_measurements.readonly.health_metrics_and_measurements.writeonly |
|
Сон
dataType:
sleepfilter parameter: sleep
Тип записи: сеанс.
Совместимые устройства
|
list, get, reconcile, create, update, batchDelete | .sleep.readonly.sleep.writeonly |
Сеансы сна и короткие пробуждения
Сеанс сна (Sleep) представляет собой отдельное событие сна, например ночной сон или дневной сон. Он включает подробную разбивку неперекрывающихся фаз сна, а также короткие интервалы перехода к бодрствованию, известные как короткие пробуждения.
- Сеанс сна (
Sleep). Отдельный период сна (интервалы стадийLIGHT,DEEP,REM,AWAKE), который разделяет непрерывную хронологию основного отдыха. - Краткие пробуждения (
shortAwakenings). Краткие переходы в состояние бодрствования или пробуждения, которые происходят во время отдыха. В отличие от стандартных интервалов фазAWAKE(которые делят непрерывную последовательность фаз сна без перекрытия), короткие пробуждения – это отдельные сегменты, которые могут перекрываться с окружающими фазами сна. Они позволяют получить подробную информацию о беспокойстве и микропробуждениях, не нарушая основную структуру фаз сна. - Пробуждения ночью. Пробуждения посреди ночи (например, чтобы попить воды) определяются с помощью датчиков на устройстве (акселерометра, гироскопа и счетчика шагов). Приложения могут обнаруживать ночные пробуждения, фильтруя
stagesпо интервалам сtype: "AWAKE"(используется в журналах снаCLASSICи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"
}
}
}
Как создать сеанс сна
Чтобы создать запись о сеансе сна, отправьте запрос POST к конечной точке элементов sleep. Ответ содержит поле name с data-point-id, которое можно использовать в запросе 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"
}
]
}
}
}Запрос и сверка сеансов сна
Чтобы получить историю сна пользователя, отправьте запрос к конечной точке reconcile, а не list. Если пользователь отслеживает сон с помощью нескольких источников, например носимого трекера и приложения "Здоровье и спорт", list возвращает все пересекающиеся записи. Суммирование необработанных результатов list может привести к двойной регистрации продолжительности сна. Конечная точка reconcile удаляет дублирующиеся записи, объединяя их в один поток, и определяет основной сеанс сна за каждый день, устанавливая для параметра sleep.metadata.mainSleep значение true. Сравнение этих конечных точек приведено в разделе Сравнение конечных точек list и reconcile.
При запросе sleep с помощью list или reconcile учитывайте следующие ограничения фильтрации и разбивки на страницы:
- Фильтровать запросы
sleepтолько по времени окончания сеанса, используяsleep.interval.end_time(физическое время по UTC) илиsleep.interval.civil_end_time(местное гражданское время). Объедините нижнюю и верхнюю границы, используя операторы сравнения>=и<сAND. - Не фильтруйте запросы
sleepпо времени начала или с помощьюOR. Фильтрация поsleep.interval.start_timeилиsleep.interval.civil_start_timeвозвращает ошибку400 Bad Request(INVALID_ARGUMENT) с причинойINVALID_DATA_POINT_FILTER_DATA_TYPE_MEMBER. При использованииORвозвращается ошибка400 Bad Request(INVALID_ARGUMENT) с причинойINVALID_DATA_POINT_FILTER_EXPRESSION_STRUCTURE. Подробные сведения о синтаксисе приведены в руководстве по фильтрации данных. - В
listиreconcileпо умолчанию и максимально применяетсяpageSize, равный25, дляsleep. Если вы передадите значениеpageSize, превышающее25, API ограничит его до25и вернет ошибку400 Bad Request, если значение отрицательное. Чтобы синхронизировать историю сна за несколько недель, используйтеnextPageToken, пока токен не станет пустым. Подробнее о запросах статистики…
Например, следующий запрос запрашивает согласованные сеансы сна, заканчивающиеся в пределах двухнедельного диапазона гражданских дат:
Запрос
GET https://health.googleapis.com/v4/users/me/dataTypes/sleep/dataPoints:reconcile ?filter=sleep.interval.civil_end_time >= "2026-03-01" AND sleep.interval.civil_end_time < "2026-03-15" &pageSize=25 Authorization: Bearer access-token Accept: application/json
Ответ
{
"dataPoints": [
{
"dataPointName": "users/user-id/dataTypes/sleep/dataPoints/data-point-id",
"sleep": {
"interval": {
"startTime": "2026-03-03T20:57:30Z",
"startUtcOffset": "0s",
"endTime": "2026-03-04T04:41:30Z",
"endUtcOffset": "0s"
},
"type": "STAGES",
"stages": [
{
"startTime": "2026-03-03T20:57:30Z",
"startUtcOffset": "0s",
"endTime": "2026-03-03T20:59:30Z",
"endUtcOffset": "0s",
"type": "AWAKE"
},
{
"startTime": "2026-03-04T04:07:30Z",
"startUtcOffset": "0s",
"endTime": "2026-03-04T04:41:30Z",
"endUtcOffset": "0s",
"type": "AWAKE"
}
],
"metadata": {
"stagesStatus": "SUCCEEDED",
"processed": true,
"mainSleep": true
},
"summary": {
"minutesInSleepPeriod": "464",
"minutesAfterWakeUp": "0",
"minutesToFallAsleep": "0",
"minutesAsleep": "407",
"minutesAwake": "57",
"stagesSummary": [
{
"type": "AWAKE",
"minutes": "56",
"count": "12"
},
{
"type": "LIGHT",
"minutes": "198",
"count": "19"
},
{
"type": "DEEP",
"minutes": "114",
"count": "10"
},
{
"type": "REM",
"minutes": "94",
"count": "4"
}
]
}
}
}
],
"nextPageToken": "Xm5h-6L0viZxIlRuWjx5bmvy98zj85uG34tuMn16mu2pntsnZI32iqhq"
}Показатели эффективности сна и задержки
Помимо фаз сна и физиологических показателей, 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.
Рекомендации по исследованию и ручному ведению журнала
Когда участники вручную записывают или корректируют время начала и окончания сна:
- Обновление границ времени в постели изменяет время сна
interval(иsummary.minutesInSleepPeriod). - Уровни сна и разделы стадий автоматически корректируются для оценки данных датчиков в новом окне.
- Оценка эффективности сна,
summary.minutesToFallAsleepиsummary.minutesAfterWakeUpпересчитываются на основе обновленного временного окна.
Ежедневные колебания температуры во время сна
Ежедневные колебания температуры во время сна – это разница между температурой кожи пользователя во время сна и ее базовым значением. Обычно эти данные передаются один раз в день после основного сеанса сна.
частота дыхания;
Частота дыхания – это количество вдохов в минуту. Во время сна это ключевой показатель для мониторинга качества сна и потенциальных нарушений. API поддерживает выборку частоты дыхания (respiratory-rate), ежедневные сводки (daily-respiratory-rate) и отчеты о сне на уровне сеанса (respiratory-rate-sleep-summary).
Вариабельность сердечного ритма (ВСР)
ВСР — это изменения интервала между сердечными ритмами. Это ключевой показатель состояния вегетативной нервной системы. Высокая ВСР во время сна обычно указывает на лучшее восстановление и готовность, а низкая ВСР может свидетельствовать о стрессе или перетренированности. API поддерживает выборку ВСР (heart-rate-variability) и ежедневные сводки (daily-heart-rate-variability).
уровень кислорода в крови;
Насыщение крови кислородом (SpO2) – это процентное соотношение насыщенного кислородом гемоглобина к общему гемоглобину в крови. Мониторинг SpO2 во время сна помогает выявить потенциальные нарушения дыхания и подтверждает, поддерживает ли пользователь адекватный уровень кислорода в течение ночи. API поддерживает выборку SpO2 (oxygen-saturation) и ежедневные сводки (daily-oxygen-saturation).
Когда вы запрашиваете данные oxygen-saturation с точностью до минуты, Google Health API возвращает только подтвержденные значения и отфильтровывает недействительные измерения, вызванные движением руки, неплотным прилеганием устройства к запястью или низкой достоверностью датчика (менее 50 %), а также показания, смежные с шумом движения. Поскольку недействительные минуты исключаются, покрытие на уровне минут может быть разреженным, а временные метки могут быть неполными. Оба приложения, oxygen-saturation и daily-oxygen-saturation, используют одни и те же проверенные показания. Подробную информацию о критериях проверки см. в разделе Фильтрация и достоверность данных SpO2 на уровне минут.
Общая картина сна и восстановления
Хотя каждый показатель предоставляет конкретную информацию, они тесно взаимосвязаны и вместе дают целостное представление о восстановлении пользователя. Фазы сна (поверхностный, глубокий, быстрый) обеспечивают структурную основу отдыха, а физиологические маркеры, такие как ВСР и SpO2, указывают на то, как организм физически реагирует на этот отдых. Например, высококачественный сеанс сна с оптимальной продолжительностью глубокого сна часто коррелирует с более высокой ВСР, что указывает на эффективное восстановление вегетативной нервной системы.
В сочетании с частотой дыхания и температурой во время сна эти данные позволяют приложениям выявлять потенциальные нарушения. Внезапный скачок частоты дыхания или отклонение температуры во время сна могут объяснить, почему пользователь провел меньше времени в восстановительных стадиях. Анализируя эти типы данных в тандеме, разработчики могут предоставить комплексную оценку гигиены сна и долгосрочных тенденций в отношении здоровья.
Правила
При интеграции показателей сна в приложение следуйте этим рекомендациям:
- Подробные сведения о сеансе. Чтобы показать фазы сна пользователя (поверхностный, глубокий, быстрый, бодрствование) и короткие пробуждения, запросите тип данных
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.
Рассчитывать общую продолжительность глубокого сна
Чтобы рассчитать общее время, которое пользователь провел в фазе глубокого сна за определенную ночь:
- Запросите тип данных
sleepза указанный диапазон дат. - Просмотрите список этапов и определите интервалы, в которых
type– этоDEEP. - Рассчитайте продолжительность (время окончания – время начала) для каждого интервала глубокого сна и сложите их.
Полученная сумма представляет собой общую физическую продолжительность глубокого сна за этот сеанс.