헬스 커넥트 데이터 유형

헬스 커넥트는 건강 및 피트니스 데이터와 의료 기록 데이터를 모두 저장하고 구조화합니다. 앱의 요구사항을 계획할 수 있도록 먼저 헬스 커넥트에서 제공하는 데이터 유형과 권한을 이해하는 것이 중요합니다.

개발 후 Play 스토어에 앱을 게시할 준비를 할 때 앱의 데이터 사용을 선언하고 앱이 사용하는 헬스 커넥트 데이터 유형에 대한 액세스 권한을 선언해야 합니다. 그렇지 않으면 특별 승인이 필요하여 앱이 헬스 커넥트 데이터 유형에 액세스할 수 없다는 오류 메시지가 사용자에게 표시될 수 있습니다.

자세한 내용은 Play Console에서 건강 앱 선언 완료하기를 참고하세요.

데이터 유형 카테고리

헬스 커넥트는 가능한 한 다양한 데이터를 제공하기 위해 대부분의 건강 및 피트니스 앱에서 사용되는 데이터 유형을 지원합니다. 헬스 커넥트는 건강 및 피트니스 데이터를 포괄적으로 확인하고 저장하는 것을 목표로 합니다. 이러한 데이터 유형은 다음 카테고리로 분류됩니다.

표: 헬스 커넥트 데이터 유형 카테고리
카테고리 설명
directions_run 활동 사용자가 하는 모든 활동을 캡처합니다. 달리기, 수영과 같은 건강 및 피트니스 활동을 포함할 수 있습니다.
straighten 신체 측정 사용자의 체중 및 기초 대사율과 같이 신체와 관련된 일반적인 데이터를 캡처합니다.
비옥한 월경 주기 추적 월경 주기 및 관련 데이터 포인트(예: 배란 테스트의 바이너리 결과)를 캡처합니다.
식료품 Nutrition 수분 섭취 및 영양 데이터 유형을 캡처합니다. 수분 섭취는 사용자가 한 번에 마신 물의 양을 나타냅니다. 영양 데이터 유형에는 칼로리, 당분, 마그네슘과 같은 선택 필드가 포함되어 있습니다.
sleep_auto 수면 사용자의 수면 시간 및 유형과 관련된 인터벌 데이터를 캡처합니다.
vital_signs Vitals 사용자의 일반적인 건강에 관한 필수 정보를 캡처합니다. 여기에는 체온, 혈당, 혈압, 혈중 산소 포화도 등의 데이터가 포함됩니다.
마음챙김 웰빙 사용자의 정신 건강 및 웰빙과 관련된 데이터를 캡처합니다.

건강 및 피트니스 데이터 유형

권한을 요청하기 전에 먼저 앱은 매니페스트에서 권한을 선언해야 합니다. 자세한 내용은 빠른 시작 가이드의 권한 선언 섹션을 참고하세요.

앱이 백그라운드에 있는 동안 데이터를 읽거나 기록 데이터를 읽으려면 데이터 유형 권한과 별도로 추가 읽기 권한 집합을 선언해야 합니다.

표: 헬스 커넥트 데이터 유형의 추가 읽기 권한
추가 읽기 권한 권한 선언
백그라운드에서 데이터 읽기
  백그라운드 읽기 예시 가이드
android.permission.health.READ_HEALTH_DATA_IN_BACKGROUND
과거 데이터 읽기
  30일이 지난 데이터 읽기 가이드
android.permission.health.READ_HEALTH_DATA_HISTORY

1. Jetpack 버전 선택

권한 선언은 Jetpack 버전에 따라 다르므로 앱에서 사용하는 Jetpack 버전 범위를 선택해야 합니다.

2. 데이터 유형 표 필터링

다음 표에는 카테고리, 기능 플래그 및 가이드, 권한 선언이 포함된 전체 데이터 유형 목록이 나와 있습니다.

표: 헬스 커넥트 데이터 유형
데이터 유형
  기능 가이드
카테고리 레코드 유형
권한 선언
기능 플래그
활동 칼로리 소모량

활동 ActiveCaloriesBurnedRecord

android.permission.health.READ_ACTIVE_CALORIES_BURNED
android.permission.health.WRITE_ACTIVE_CALORIES_BURNED
활동 강도

활동 ActivityIntensityRecord

android.permission.health.READ_ACTIVITY_INTENSITY
android.permission.health.WRITE_ACTIVITY_INTENSITY

FEATURE_ACTIVITY_INTENSITY

기초 체온

월경 주기 추적 BasalBodyTemperatureRecord

android.permission.health.READ_BASAL_BODY_TEMPERATURE
android.permission.health.WRITE_BASAL_BODY_TEMPERATURE
기초대사율

신체 측정 BasalMetabolicRateRecord

android.permission.health.READ_BASAL_METABOLIC_RATE
android.permission.health.WRITE_BASAL_METABOLIC_RATE
혈당

Vitals BloodGlucoseRecord

android.permission.health.READ_BLOOD_GLUCOSE
android.permission.health.WRITE_BLOOD_GLUCOSE
혈압

Vitals BloodPressureRecord

android.permission.health.READ_BLOOD_PRESSURE
android.permission.health.WRITE_BLOOD_PRESSURE
체지방

신체 측정 BodyFatRecord

android.permission.health.READ_BODY_FAT
android.permission.health.WRITE_BODY_FAT
체온

Vitals BodyTemperatureRecord

android.permission.health.READ_BODY_TEMPERATURE
android.permission.health.WRITE_BODY_TEMPERATURE
체내 수분량

신체 측정 BodyWaterMassRecord

android.permission.health.READ_BODY_WATER_MASS
android.permission.health.WRITE_BODY_WATER_MASS
골질량

신체 측정 BoneMassRecord

android.permission.health.READ_BONE_MASS
android.permission.health.WRITE_BONE_MASS
자궁경관 점액

월경 주기 추적 CervicalMucusRecord

android.permission.health.READ_CERVICAL_MUCUS
android.permission.health.WRITE_CERVICAL_MUCUS
사이클링 페달 회전수

활동 CyclingPedalingCadenceRecord

android.permission.health.READ_EXERCISE
android.permission.health.WRITE_EXERCISE
Distance

활동 DistanceRecord

android.permission.health.READ_DISTANCE
android.permission.health.WRITE_DISTANCE
상승 고도

활동 ElevationGainedRecord

android.permission.health.READ_ELEVATION_GAINED
android.permission.health.WRITE_ELEVATION_GAINED
운동

  운동 경로 추가 가이드
활동 ExerciseSessionRecord

android.permission.health.READ_EXERCISE
android.permission.health.READ_EXERCISE_ROUTE
android.permission.health.WRITE_EXERCISE
android.permission.health.WRITE_EXERCISE_ROUTE

운동 유형

모든 운동 유형 보기
EXERCISE_TYPE_UNKNOWN
EXERCISE_TYPE_BADMINTON
EXERCISE_TYPE_BASEBALL
EXERCISE_TYPE_BASKETBALL
EXERCISE_TYPE_BIKING
EXERCISE_TYPE_BIKING_STATIONARY
EXERCISE_TYPE_BOOT_CAMP
EXERCISE_TYPE_BOXING
EXERCISE_TYPE_CALISTHENICS
EXERCISE_TYPE_CRICKET
EXERCISE_TYPE_DANCING
EXERCISE_TYPE_ELLIPTICAL
EXERCISE_TYPE_EXERCISE_CLASS
EXERCISE_TYPE_FENCING
EXERCISE_TYPE_FOOTBALL_AMERICAN
EXERCISE_TYPE_FOOTBALL_AUSTRALIAN
EXERCISE_TYPE_FRISBEE_DISC
EXERCISE_TYPE_GOLF
EXERCISE_TYPE_GUIDED_BREATHING
EXERCISE_TYPE_GYMNASTICS
EXERCISE_TYPE_HANDBALL
EXERCISE_TYPE_HIGH_INTENSITY_INTERVAL_TRAINING
EXERCISE_TYPE_HIKING
EXERCISE_TYPE_ICE_HOCKEY
EXERCISE_TYPE_ICE_SKATING
EXERCISE_TYPE_MARTIAL_ARTS
EXERCISE_TYPE_PADDLING
EXERCISE_TYPE_PARAGLIDING
EXERCISE_TYPE_PILATES
EXERCISE_TYPE_RACQUETBALL
EXERCISE_TYPE_ROCK_CLIMBING
EXERCISE_TYPE_ROLLER_HOCKEY
EXERCISE_TYPE_ROWING
EXERCISE_TYPE_ROWING_MACHINE
EXERCISE_TYPE_RUGBY
EXERCISE_TYPE_RUNNING
EXERCISE_TYPE_RUNNING_TREADMILL
EXERCISE_TYPE_SAILING
EXERCISE_TYPE_SCUBA_DIVING
EXERCISE_TYPE_SKATING
EXERCISE_TYPE_SKIING
EXERCISE_TYPE_SNOWBOARDING
EXERCISE_TYPE_SNOWSHOEING
EXERCISE_TYPE_SOCCER
EXERCISE_TYPE_SOFTBALL
EXERCISE_TYPE_SQUASH
EXERCISE_TYPE_STAIR_CLIMBING
EXERCISE_TYPE_STAIR_CLIMBING_MACHINE
EXERCISE_TYPE_STRENGTH_TRAINING
EXERCISE_TYPE_STRETCHING
EXERCISE_TYPE_SURFING
EXERCISE_TYPE_SWIMMING_OPEN_WATER
EXERCISE_TYPE_SWIMMING_POOL
EXERCISE_TYPE_TABLE_TENNIS
EXERCISE_TYPE_TENNIS
EXERCISE_TYPE_VOLLEYBALL
EXERCISE_TYPE_WALKING
EXERCISE_TYPE_WATER_POLO
EXERCISE_TYPE_WEIGHTLIFTING
EXERCISE_TYPE_WHEELCHAIR
EXERCISE_TYPE_OTHER_WORKOUT
EXERCISE_TYPE_YOGA
오른 계단수

활동 FloorsClimbedRecord

android.permission.health.READ_FLOORS_CLIMBED
android.permission.health.WRITE_FLOORS_CLIMBED
심박수

Vitals HeartRateRecord

android.permission.health.READ_HEART_RATE
android.permission.health.WRITE_HEART_RATE
심박 변이도

Vitals HeartRateVariabilityRmssdRecord

android.permission.health.READ_HEART_RATE_VARIABILITY
android.permission.health.WRITE_HEART_RATE_VARIABILITY
Height

신체 측정 HeightRecord

android.permission.health.READ_HEIGHT
android.permission.health.WRITE_HEIGHT
수분

영양 HydrationRecord

android.permission.health.READ_HYDRATION
android.permission.health.WRITE_HYDRATION
월경간출혈

월경 주기 추적 IntermenstrualBleedingRecord

android.permission.health.READ_INTERMENSTRUAL_BLEEDING
android.permission.health.WRITE_INTERMENSTRUAL_BLEEDING
제지방량

신체 측정 LeanBodyMassRecord

android.permission.health.READ_LEAN_BODY_MASS
android.permission.health.WRITE_LEAN_BODY_MASS
Menstruation

월경 주기 추적 MenstruationFlowRecord

MenstruationPeriodRecord

android.permission.health.READ_MENSTRUATION
android.permission.health.WRITE_MENSTRUATION
마음챙김

  마음챙김 추적 가이드
웰빙 MindfulnessSessionRecord

android.permission.health.READ_MINDFULNESS
android.permission.health.WRITE_MINDFULNESS

FEATURE_MINDFULNESS_SESSION

영양

영양 NutritionRecord

android.permission.health.READ_NUTRITION
android.permission.health.WRITE_NUTRITION
배란 테스트

월경 주기 추적 OvulationTestRecord

android.permission.health.READ_OVULATION_TEST
android.permission.health.WRITE_OVULATION_TEST
산소 포화도

Vitals OxygenSaturationRecord

android.permission.health.READ_OXYGEN_SATURATION
android.permission.health.WRITE_OXYGEN_SATURATION
계획된 운동

  운동 계획 가이드
활동 PlannedExerciseSessionRecord

android.permission.health.READ_PLANNED_EXERCISE
android.permission.health.WRITE_PLANNED_EXERCISE

FEATURE_PLANNED_EXERCISE

전원

활동 PowerRecord

android.permission.health.READ_POWER
android.permission.health.WRITE_POWER
호흡수

Vitals RespiratoryRateRecord

android.permission.health.READ_RESPIRATORY_RATE
android.permission.health.WRITE_RESPIRATORY_RATE
안정 시 심박수

Vitals RestingHeartRateRecord

android.permission.health.READ_RESTING_HEART_RATE
android.permission.health.WRITE_RESTING_HEART_RATE
성적인 활동

활동 SexualActivityRecord

android.permission.health.READ_SEXUAL_ACTIVITY
android.permission.health.WRITE_SEXUAL_ACTIVITY
피부 온도

  피부 온도 측정 가이드
Vitals SkinTemperatureRecord

android.permission.health.READ_SKIN_TEMPERATURE
android.permission.health.WRITE_SKIN_TEMPERATURE

FEATURE_SKIN_TEMPERATURE

수면 세션

  수면 세션 추적 가이드
절전 모드 SleepSessionRecord

android.permission.health.READ_SLEEP
android.permission.health.WRITE_SLEEP
속도

활동 SpeedRecord

android.permission.health.READ_SPEED
android.permission.health.WRITE_SPEED
단계

활동 StepsRecord

StepsCadenceRecord

android.permission.health.READ_STEPS
android.permission.health.WRITE_STEPS
총 칼로리 소모량

활동 TotalCaloriesBurnedRecord

android.permission.health.READ_TOTAL_CALORIES_BURNED
android.permission.health.WRITE_TOTAL_CALORIES_BURNED
최대 산소 소비량

활동 Vo2MaxRecord

android.permission.health.READ_VO2_MAX
android.permission.health.WRITE_VO2_MAX
가중치

신체 측정 WeightRecord

android.permission.health.READ_WEIGHT
android.permission.health.WRITE_WEIGHT
휠체어 밀기

활동 WheelchairPushesRecord

android.permission.health.READ_WHEELCHAIR_PUSHES
android.permission.health.WRITE_WHEELCHAIR_PUSHES