Типы данных API Google Health

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

Примечание: устройства Fitbit Ace не поддерживаются API Health. Для получения дополнительной информации см. Политику конфиденциальности Fitbit для детских учетных записей .

Поля типа данных

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

Таблица: Описание полей типов данных API Google Health

Поле	Описание
dataType	Идентификатор, разделённый дефисами (например, active-minutes ), используемый в URL-адресах конечных точек.
параметр filter	Идентификатор, разделённый символами подчеркивания (например, active_minutes ), используется в качестве значения параметра фильтра dataType в ежедневных сводных данных и запросах сводных данных.
Тип записи	Указывает структуру и формат записываемых данных. В основе этого лежит представление данных в виде ресурса. Возможные значения: Интервал : обозначает измерения, зарегистрированные в течение определенного периода времени. Образец : Представляет собой мгновенные измерения. Сессия : Представляет собой непрерывный блок записи, например, тренировку или сеанс электрокардиограммы (ЭКГ). Еда : обозначает продукт питания или объект данных, связанный с питанием. Ежедневно : Представляет собой агрегированные или зарегистрированные за сутки измерения.
Доступные операции	Отображает список методов API, поддерживаемых для данного типа данных (таких как list , create и rollUp ).
Объем	Требуемые области действия OAuth для доступа к данному типу данных.
Поддержка веб-хуков	Указывает на то, что данный тип данных поддерживает уведомления в реальном времени с использованием веб-хуков при синхронизации новых данных.
Поддержка истинных нулей	Указывает на то, что данный тип данных поддерживает запись явных нулевых значений для различения нулевого значения активности (например, нулевого количества активных минут) от отсутствующих или незарегистрированных данных.
Совместимые устройства	Расширяемый список физических устройств, которые могут записывать и синхронизировать этот тип данных с API Google Health (с помощью приложения Fitbit).

Таблица: Типы данных API Google Health

Тип данных	Доступный операции	Объем
Сожженная активная энергия dataType: active-energy-burned Параметр фильтра: active_energy_burned Тип записи: Интервал Руководство по калориям и энергетической ценности	список, сверка, свертка, ежедневная сводка	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Активные минуты Тип данных: active-minutes Параметр фильтра: active_minutes Тип записи: Интервал Совместимые устройства Фитнес-браслет Fitbit Air Fitbit Alta Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Flex 2 Fitbit Inspire Fitbit Inspire HR Pixel Watch 4	список, сверка, свертка, ежедневная сводка	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Минуты активной зоны dataType: active-zone-minutes Параметр фильтра: active_zone_minutes Тип записи: Интервал Поддержка веб-хуков Совместимые устройства Фитнес-браслет Fitbit Air Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Фитнес-браслет 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 Fitbit Versa Lite	список, сверка, свертка, ежедневная сводка	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Уровень активности Тип данных: activity-level Параметр фильтра: activity_level Тип записи: Интервал Поддержка веб-хуков	список, согласовать	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Высота Тип данных: altitude Параметр фильтра: altitude Тип записи: Интервал Поддержка веб-хуков Поддержка истинных нулей	список, сверка, свертка, ежедневная сводка	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Уровень глюкозы в крови Тип данных: blood-glucose Параметр фильтра: blood_glucose Тип записи: Образец Руководство по поддержке вебхуков.	список, получить, согласовать, свернуть, ежедневный свертывание	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Жировая масса тела Тип данных: body-fat Параметр фильтра: body_fat Тип записи: Образец Поддержка веб-хуков Совместимые устройства Fitbit Aria Fitbit Aria 2 Fitbit Aria Air	список, получить, согласовать, свернуть, ежедневный свертывание, создать, обновить, пакетное удаление	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Калории в зоне частоты сердечных сокращений dataType: calories-in-heart-rate-zone Параметр фильтра: calories_in_heart_rate_zone Тип записи: Интервал Поддержка веб-хуков	rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Температура тела Тип данных: core-body-temperature Параметр фильтра: core_body_temperature Тип записи: Образец Руководство по жизненно важным показателям	список, получить, согласовать, свернуть, ежедневный свертывание	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Суточная вариабельность сердечного ритма Тип данных: 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
Ежедневные зоны частоты сердечных сокращений dataType: daily-heart-rate-zones Параметр фильтра: daily_heart_rate_zones Тип записи: Ежедневная Руководство по поддержке вебхуков.	список, согласовать	.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
Ежедневная частота сердечных сокращений в состоянии покоя dataType: daily-resting-heart-rate Параметр фильтра: daily_resting_heart_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 Fitbit Versa Lite	список, согласовать	.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
Ежедневный VO2 Max dataType: daily-vo2-max Параметр фильтра: daily_vo2_max Тип записи: Ежедневная Совместимые устройства Фитнес-браслет 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 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	список, согласовать	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Расстояние Тип данных: distance Параметр фильтра: distance Тип записи: Интервал Поддержка веб-хуков Поддержка истинных нулей Совместимые устройства Фитнес-браслет 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	список, сверка, свертка, ежедневная сводка	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Электрокардиограмма (ЭКГ) Тип данных: electrocardiogram Параметр фильтра: electrocardiogram Тип записи: Сессия Руководство по жизненно важным показателям Совместимые устройства Fitbit Charge 5 Fitbit Charge 6 Пиксельные часы Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2	список	.ecg.readonly
Упражнение Тип данных: exercise Параметр фильтра: exercise Тип записи: Сессия Руководство по тренировкам с поддержкой веб-хуков Совместимые устройства Фитнес-браслет 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	список, получить, согласовать, создать, обновить, пакетное удаление	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Полы Тип данных: floors Параметр фильтра: floors Тип записи: Интервал Поддержка веб-хуков Поддержка истинных нулей	reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Еда Тип данных: food Параметр фильтра: food Тип записи: Еда Руководство по питанию	список, получить	.nutrition.readonly .nutrition.writeonly
Измерительный прибор для пищевых продуктов Тип данных: food-measurement-unit Параметр фильтра: food_measurement_unit Тип записи: Еда Руководство по питанию Совместимые устройства Фитнес-браслет Fitbit Air Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Ionic Пиксельные часы 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	список, получить	.nutrition.readonly .nutrition.writeonly
Частота сердечных сокращений Тип данных: heart-rate Параметр фильтра: heart_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 Fitbit Versa Lite	список, сверка, свертка, ежедневная сводка	.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
Высота Тип данных: height Параметр фильтра: height Тип записи: Образец Поддержка веб-хуков	список, получить, согласовать, создать, обновить, пакетное удаление	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly
Журнал учета потребления жидкости Тип данных: hydration-log Параметр фильтра: hydration_log Тип записи: Сессия Поддержка веб-хуков	список, получить, согласовать, свернуть, ежедневный свертывание, создать, обновить, пакетное удаление	.nutrition.readonly .nutrition.writeonly
Уведомление о нарушении ритма dataType: irregular-rhythm-notification Параметр фильтра: irregular_rhythm_notification Тип записи: Сессия Руководство по жизненно важным показателям	список	.irn.readonly
Менструация Тип данных: menstrual-period Параметр фильтра: menstrual_period Тип записи: Интервал Руководство по женскому здоровью	создать, обновить, удалить пакетом	.reproductive_health.writeonly
Настроения Тип данных: moods Параметр фильтра: moods Тип записи: Образец Руководство по женскому здоровью	создать, обновить, удалить пакетом	.mindfulness.writeonly
Журнал учета пищевых продуктов Тип данных: nutrition-log Параметр фильтра: nutrition_log Тип записи: Образец Поддержка веб-хуков Руководство по питанию Совместимые устройства Фитнес-браслет Fitbit Air Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Inspire 2 Фитнес-браслет Fitbit Inspire 3 Fitbit Luxe Пиксельные часы Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	список, получить, согласовать, свернуть, ежедневный свертывание, создать, обновить, пакетное удаление	.nutrition.readonly .nutrition.writeonly
Тест на овуляцию Тип данных: ovulation-test Параметр фильтра: ovulation_test Тип записи: Образец Руководство по женскому здоровью	создать, обновить, удалить пакетом	.reproductive_health.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
Сводка по частоте дыхания во сне dataType: 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
Бег VO2 Max dataType: run-vo2-max Параметр фильтра: run_vo2_max Тип записи: Образец Поддержка веб-хуков Совместимые устройства Фитнес-браслет 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 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	список, сверка, свертка, ежедневная сводка	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Сидячий период dataType: sedentary-period Параметр фильтра: sedentary_period Тип записи: Интервал Поддержка веб-хуков Совместимые устройства Фитнес-браслет 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	список, сверка, свертка, ежедневная сводка	.activity_and_fitness.readonly .activity_and_fitness.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
Шаги Тип данных: steps Параметр фильтра: steps Тип записи: Интервал Поддержка веб-хуков Поддержка истинных нулей Руководство по шагам Совместимые устройства Фитнес-браслет 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	список, сверка, свертка, ежедневная сводка	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Данные о длине заплывов dataType: swim-lengths-data Параметр фильтра: swim_lengths_data Тип записи: Интервал Совместимые устройства Фитнес-браслет Fitbit Air 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	список, сверка, свертка, ежедневная сводка	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Симптомы Тип данных: symptoms Параметр фильтра: symptoms Тип записи: Образец Руководство по женскому здоровью	создать, обновить, удалить пакетом	.logged_symptoms.writeonly
Время в зоне частоты сердечных сокращений dataType: time-in-heart-rate-zone Параметр фильтра: time_in_heart_rate_zone Тип записи: Интервал Поддержка веб-хуков	список, сверка, свертка, ежедневная сводка	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Общее количество калорий Тип данных: total-calories Параметр фильтра: total_calories Тип записи: Интервал Поддержка концепции «Истинные нули»: руководство по калориям и энергии Совместимые устройства Фитнес-браслет 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	rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
VO2 Max Тип данных: vo2-max Параметр фильтра: vo2_max Тип записи: Образец Совместимые устройства Фитнес-браслет 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 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	список, согласовать	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Масса Тип данных: weight Параметр фильтра: weight Тип записи: Образец Поддержка веб-хуков Совместимые устройства Fitbit Aria Fitbit Aria 2 Fitbit Aria Air	список, получить, согласовать, свернуть, ежедневный свертывание, создать, обновить, пакетное удаление	.health_metrics_and_measurements.readonly .health_metrics_and_measurements.writeonly

Ограничения запроса

При запросе данных, сводных отчетов или ежедневных сводок через API следует учитывать следующие ограничения:

• Требования к фильтру: Для некоторых производных типов данных, доступных только для чтения, таких как total-calories , требуется фильтр, указывающий время начала интервала (с использованием физического или гражданского времени).
• Ограничения диапазона запросов: Конечные точки агрегирования сводных и ежедневных сводных данных устанавливают максимальные ограничения диапазона запросов в зависимости от типа данных:
  • Максимальный диапазон запросов для calories-in-heart-rate-zone , heart-rate , active-minutes и total-calories составляет 14 дней.
  • Для всех остальных типов данных максимальный диапазон запросов составляет 90 дней.

Доступность данных

Обновление данных пользователя доступно только после синхронизации трекера активности или ручного ввода новых данных в мобильное или веб-приложение Fitbit. Устройство Fitbit и мобильное приложение Fitbit могут автоматически синхронизироваться каждые 15 минут, когда приложение Fitbit открыто на мобильном устройстве, и оба устройства имеют активное соединение для передачи данных и находятся в зоне действия Bluetooth. Если пользователь отслеживает активность с помощью MobileTrack, MobileTrack синхронизируется каждый час, пока приложение открыто.

Запрос исторических данных

Одно из главных преимуществ API Google Health — возможность отслеживать производительность пользователя и контролировать показатели его здоровья в течение длительных периодов времени. Вы можете запрашивать данные пользователя за весь период, с момента их записи; API не накладывает никаких ограничений на объем исторических данных, которые может обрабатывать ваше приложение.

Однако запросы к историческим данным по-прежнему регулируются стандартными ограничениями скорости . Для обеспечения стабильности системы и предотвращения чрезмерной нагрузки API Google Health использует автоматическую пагинацию с размерами страниц, специфичными для каждой конечной точки. Обратите внимание на следующие ограничения и поведение:

• Автоматическая пагинация: если вы запрашиваете большой объем данных, API вернет только первую страницу результатов, не превышающую лимит размера страницы для данной конечной точки, вместе с токеном nextPageToken . Для запроса последующих страниц необходимо использовать nextPageToken .
• Размер страниц может варьироваться: ограничения зависят от конечной точки и типа данных. Для большинства типов данных размер страниц ограничен максимум 10 000. Однако для некоторых типов данных, таких как exercise и sleep , размер страницы по умолчанию ограничен 25. Например, если клиент запрашивает все данные о сне за последние 10 лет, API все равно вернет только 25 сеансов сна на первой странице.
• Ограничения по диапазону дат для сводных данных: Для конечных точек сводных и агрегированных данных (таких как rollUp и dailyRollUp ) диапазоны дат запросов ограничены в зависимости от типа данных:
  • Максимальный диапазон в 14 дней для calories-in-heart-rate-zone , heart-rate , active-minutes и total-calories .
  • Для всех остальных типов сводных данных максимальный диапазон составляет 90 дней.

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

Для обеспечения оптимальной производительности и во избежание ошибок API следуйте этим рекомендациям при запросе исторических данных:

Поэтапная синхронизация данных (горячая и холодная загрузка)

• Первоначальная «горячая» загрузка: во время основной последовательности загрузки загружаются и отображаются только данные за последние 7–14 дней. Это гарантирует, что пользователи увидят данные немедленно, без ожидания завершения длительных запросов.
• Фоновая «холодная» загрузка: после отрисовки основного пользовательского интерфейса перенаправьте получение более старых исторических данных в асинхронную очередь с более низким приоритетом или фоновый процесс.

Разбиение запросов на фрагменты для агрегирования

• Поскольку конечные точки для агрегирования и ежедневного агрегирования устанавливают ограничение на максимальный диапазон дат (14 или 90 дней в зависимости от типа данных), необходимо разбивать большие запросы на агрегирование исторических данных на более мелкие последовательные интервалы в пределах этих ограничений.
• Безопасно объединяйте или упорядочивайте эти подзапросы, чтобы соблюдать ограничения на параллельное выполнение и поддерживать стабильные индикаторы выполнения пользовательского интерфейса.

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

Реструктурируйте обзорные панели мониторинга и графики трендов, используя предварительно агрегированные сводные данные (например, DailyRollUpDataPoints ). Это значительно снизит вычислительную нагрузку на бэкэнд и время передачи данных по сети клиенту.

Устойчивая обработка ошибок (интеллектуальные повторные попытки)

• Внедрите строгую экспоненциальную обработку при столкновении с ограничениями скорости ( 429 Too Many Requests ) и таймаутами шлюза сервера ( 504 Gateway Timeout ). Никогда не повторяйте сразу большие, неудачно завершившиеся запросы. Мгновенные повторные попытки увеличивают перегрузку бэкэнда и усугубляют деградацию системы.

Внимание: Несоблюдение этих рекомендаций может привести к непредсказуемому поведению и ошибкам.

Доступ третьих лиц

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

Устройство автоматически синхронизирует данные в течение дня, когда открыто приложение Fitbit, или каждые 15 минут, если Bluetooth активен и приложение работает в фоновом режиме. После завершения процесса синхронизации данные становятся доступны сторонним сервисам через API Google Health.

стандарты расстояния

Дистанция, измеряемая во время упражнений, например, elevationGainMillimeters в миллиметрах, стандартной единицей измерения является миллиметр по следующим причинам:

1. Сохранение точности данных : Главная причина использования миллиметров — это обеспечение точности считываемых и предоставляемых данных. Использование такой точной единицы, как миллиметры, позволяет представлять измерения с высокой точностью.
2. Стандартизация : Миллиметры — это стандартизированная единица измерения, используемая во всех наших сервисах. Такая согласованность помогает обеспечить единообразие взаимодействия разработчиков с различными частями API.
3. Широкая поддержка систем измерения : использование базовой единицы, такой как миллиметры, упрощает разработчикам преобразование в любую другую выбранную единицу, независимо от того, работают ли они с метрической, имперской или другими системами измерения.

Переменная продолжительность светового дня

API Health обрабатывает время, отдавая приоритет времени пользователя, чтобы учесть переменную продолжительность дня, вызванную переходом на летнее время или поездками. Каждая точка данных хранится как с физической меткой времени UTC, так и с активным смещением UTC на момент события. Это позволяет системе:

• Сопоставьте событие с точным физическим моментом времени.
• Для агрегирования данных необходимо скорректировать время в соответствии с локальным контекстом пользователя.

Переход на летнее время

При переходе на летнее время происходит «перевод назад», в результате чего гражданские сутки становятся 25-часовыми, и сводная таблица за эту дату будет содержать 25 часов данных. При переводе назад, в результате, гражданские сутки становятся 23-часовыми, и время возвращается к стандартному времени.

Путешествовать

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

Используйте конечную точку dailyRollUp для согласования разницы во времени. Она автоматически привязывает данные к календарному дню, в который они были записаны, в соответствии с местным временем пользователя, эффективно «сшивая» данные за день, несмотря на сдвиги во времени.