다음 표에는 데이터 유형의 전체 목록과 Google Health API에서 각 유형의 표현을 이해하는 데 도움이 되는 여러 열, 각 유형을 사용할 수 있는 범위가 포함되어 있습니다.
데이터 유형dataType
filter 매개변수 |
기록 유형 |
사용 가능한 작업 |
범위 | 웹훅 지원 |
|---|---|---|---|---|
활동적 시간(분)
active-minutesactive_minutes
|
인터벌 | reconcile, rollup, dailyRollup | activity_and_fitness | |
액티브존 미닛
active-zone-minutesactive_zone_minutes
|
간격 | list, reconcile, rollup, dailyRollup | activity_and_fitness | |
활동 수준
activity-levelactivity_level
|
간격 | list, reconcile | activity_and_fitness | |
고도
altitudealtitude
|
인터벌 | list, reconcile, rollup, dailyRollup | activity_and_fitness | |
체지방
body-fatbody_fat
|
샘플 | list, get, reconcile, rollup, dailyRollup, create, update, batchDelete | health_metrics_and_measurements | |
심박수 구간별 칼로리
calories-in-heart-rate-zonecalories_in_heart_rate_zone
|
인터벌 | rollup, dailyRollup | activity_and_fitness | |
일일 심박 변이도
daily-heart-rate-variabilitydaily_heart_rate_variability
|
매일 | list, reconcile | health_metrics_and_measurements | |
일일 심박수 구간
daily-heart-rate-zonesdaily_heart_rate_zones
|
매일 | reconcile | health_metrics_and_measurements | |
일일 산소 포화도
daily-oxygen-saturationdaily_oxygen_saturation
|
매일 | list, reconcile | health_metrics_and_measurements | |
일일 호흡수
daily-respiratory-ratedaily_respiratory_rate
|
매일 | list, reconcile | health_metrics_and_measurements | |
일일 안정 시 심박수
daily-resting-heart-ratedaily_resting_heart_rate
|
매일 | list, reconcile | health_metrics_and_measurements | |
일일 수면 온도 파생
daily-sleep-temperature-derivationsdaily_sleep_temperature_derivations
|
매일 | list, reconcile | health_metrics_and_measurements | |
일일 최대 산소 섭취량
daily-vo2-maxdaily_vo2_max
|
매일 | list, reconcile | activity_and_fitness | |
거리
distancedistance
|
간격 | list, reconcile, rollup, dailyRollup | activity_and_fitness | |
운동
exerciseexercise
|
세션 | list, get, reconcile, create, update, batchDelete | activity_and_fitness | |
층수
floorsfloors
|
간격 | reconcile, rollup, dailyRollup | activity_and_fitness | |
심박수
heart-rateheart_rate
|
샘플 | list, reconcile, rollup, dailyRollup | health_metrics_and_measurements | |
심박 변이도
heart-rate-variabilityheart_rate_variability
|
샘플 | list, reconcile | health_metrics_and_measurements | |
키
heightheight
|
샘플 | list, get, reconcile, create, update, batchDelete | health_metrics_and_measurements | |
수분 섭취 기록
hydration-loghydration_log
|
세션 | list, get, reconcile, rollup, dailyRollup, create, update, batchDelete | nutrition | |
산소 포화도
oxygen-saturationoxygen_saturation
|
샘플 | list, reconcile | health_metrics_and_measurements | |
호흡수 수면 요약
respiratory-rate-sleep-summaryrespiratory_rate_sleep_summary
|
샘플 | list, reconcile | health_metrics_and_measurements | |
러닝 최대 산소 섭취량
run-vo2-maxrun_vo2_max
|
샘플 | list, reconcile, rollup, dailyRollup | activity_and_fitness | |
앉아 있는 시간
sedentary-periodsedentary_period
|
인터벌 | list, reconcile, rollup, dailyRollup | activity_and_fitness | |
수면
sleepsleep
|
세션 | list, get, reconcile, create, update, batchDelete | sleep | |
걸음 수
stepssteps
|
인터벌 | list, reconcile, rollup, dailyRollup | activity_and_fitness | |
수영 거리 데이터
swim-lengths-dataswim_lengths_data
|
간격 | list, reconcile, rollup, dailyRollup | activity_and_fitness | |
심박수 구간별 시간
time-in-heart-rate-zonetime_in_heart_rate_zone
|
간격 | reconcile, rollup, dailyRollup | activity_and_fitness | |
총 칼로리
total-caloriestotal_calories
|
간격 | rollup, dailyRollup | activity_and_fitness | |
최대 산소 섭취량
vo2-maxvo2_max
|
샘플 | list, reconcile | activity_and_fitness | |
체중
weightweight
|
샘플 | list, get, reconcile, rollup, dailyRollup, create, update, batchDelete | health_metrics_and_measurements |
데이터 사용 가능 여부
사용자의 데이터 업데이트는 활동 트래커를 동기화하거나 Fitbit 모바일 또는 웹 앱에 새 데이터를 수동으로 입력한 후에만 사용할 수 있습니다. Fitbit 기기와 Fitbit 모바일 앱은 모바일 기기에서 Fitbit 앱이 열려 있고 두 기기가 활성 데이터 연결을 보유하고 있으며 블루투스 범위 내에 있는 경우 15분마다 자동으로 동기화할 수 있습니다. 사용자가 MobileTrack을 사용하여 활동을 추적하는 경우 앱이 열려 있는 한 MobileTrack은 매시간 동기화됩니다.
서드 파티 액세스
Fitbit 기기는 서드 파티 애플리케이션 또는 서비스와 직접 통신할 수 없습니다. 이러한 기기는 Fitbit 모바일 앱과만 통신하고 동기화하도록 설계되었습니다.
Fitbit 앱이 열려 있을 때 또는 블루투스가 활성 상태이고 앱이 백그라운드에서 실행 중인 경우 15분마다 기기가 하루 종일 데이터를 자동으로 동기화합니다. 이 동기화 프로세스가 완료되면 Google Health API를 통해 서드 파티 서비스에서 데이터를 사용할 수 있습니다.
거리 표준
elevationGainMillimeters와 같은 운동 거리는 다음과 같은 이유로 표준 단위인 밀리미터로 측정됩니다.
- 데이터 정밀도 유지: 밀리미터를 사용하는 가장 중요한 이유는 읽고 제공하는 데이터의 정밀도를 유지하기 위해서입니다. 밀리미터와 같은 세분화된 단위를 사용하면 측정값을 높은 정확도로 나타낼 수 있습니다.
- 표준화: 밀리미터는 Google 서비스 전반에서 설계된 표준화된 단위입니다. 이 일관성은 API의 여러 부분과 상호작용하는 개발자에게 일관된 환경을 제공하는 데 도움이 됩니다.
- 광범위한 측정 시스템 지원: 밀리미터와 같은 기본 단위를 사용하면 개발자가 미터법, 영국식 또는 기타 측정 시스템을 사용하는지 여부에 관계없이 선택한 다른 단위로 쉽게 변환할 수 있습니다.