건강 데이터 유형

Google 피트니스에는 피트니스가 아닌 일반적인 건강 관리와 관련된 측정을 위한 건강 데이터 유형이 있습니다.

데이터 유형 목록

건강 데이터 유형과 필드에 관한 자세한 내용은 Android 참조 문서를 참고하세요. 단위가 enum인 필드에는 선택할 수 있는 허용된 값 목록이 있습니다. 데이터를 성공적으로 읽고 쓰려면 허용된 값 중 하나만 사용하세요.

혈당

이 데이터 유형은 혈당 농도를 캡처합니다. 각 데이터 포인트는 단일의 즉각적인 혈당 측정값을 나타냅니다. 혈당 데이터 작성에 대해 자세히 알아보세요.

REST

이름com.google.blood_glucose
OAuth 권한 범위
https://www.googleapis.com/auth/fitness.blood_glucose.read
https://www.googleapis.com/auth/fitness.blood_glucose.write
필드 (형식—단위)
혈당 수치 (float—mmol/L)
1mmol/L가 18mg/dL일 때 혈당 수준 또는 농도(mmol/L)입니다.
식사와의 시간적 관계 (int—열거형) (선택적 필드)
사용자가 식사할 때와 비교하여 읽은 시간입니다.
meal type (int—열거형) (선택 필드)
측정값을 구할 때 사용자가 먹은 식사 유형입니다.
수면과의 시간 관계 (int—열거형) (선택적 필드)
사용자가 수면을 취한 시간과 비교하여 측정값을 구한 시간입니다.
표본 소스 (int—열거형) (선택적 필드)
혈당 측정에 사용되는 체액 유형입니다.

Android

이름com.google.blood_glucose
데이터 유형 객체TYPE_BLOOD_GLUCOSE
필드 (형식—단위)
FIELD_BLOOD_GLUCOSE_LEVEL (float—mmol/L)
1mmol/L가 18mg/dL일 때 혈당 수준 또는 농도(mmol/L)입니다.
FIELD_TEMPORAL_RELATION_TO_MEAL (int—열거형) (선택적 입력란)
사용자가 식사할 때와 비교하여 읽은 시간입니다.
FIELD_MEAL_TYPE (int—열거형) (선택적 입력란)
측정값을 구할 때 사용자가 먹은 식사 유형입니다.
FIELD_TEMPORAL_RELATION_TO_SLEEP (int—열거형) (선택적 필드)
사용자가 수면을 취한 시간과 비교하여 측정값을 구한 시간입니다.
FIELD_BLOOD_GLUCOSE_SPECIMEN_SOURCE (int—열거형) (선택 입력란)
혈당 측정에 사용되는 체액 유형입니다.

혈압

이 데이터 유형은 사용자의 혈압을 캡처합니다. 각 데이터 포인트는 단일의 즉각적인 혈압 측정값을 나타냅니다. 혈압 데이터 작성에 대해 자세히 알아보세요.

REST

이름com.google.blood_pressure
OAuth 권한 범위
https://www.googleapis.com/auth/fitness.blood_pressure.read
https://www.googleapis.com/auth/fitness.blood_pressure.write
필드 (형식—단위)
수축기 (float—mmHg)
수축기 혈압 측정치입니다.
확장기 (float—mmHg)
이완기 혈압 측정입니다.
body position (int—enum) (선택적 필드)
측정값이 측정된 사용자의 신체 위치입니다.
측정 위치 (int: 열거형) (선택적 필드)
측정이 이루어진 팔과 팔의 일부

Android

이름com.google.blood_pressure
데이터 유형 객체TYPE_BLOOD_PRESSURE
필드 (형식—단위)
FIELD_BLOOD_PRESSURE_SYSTOLIC (float—mmHg)
수축기 혈압 측정치입니다.
FIELD_BLOOD_PRESSURE_DIASTOLIC (float—mmHg)
이완기 혈압 측정입니다.
FIELD_BODY_POSITION (int—열거형) (선택적 필드)
측정값이 측정된 사용자의 신체 위치입니다.
FIELD_BLOOD_PRESSURE_MEASUREMENT_LOCATION (int—열거형) (선택 입력란)
측정이 이루어진 팔과 팔의 일부

체지방률

이 데이터 유형은 사용자의 체지방률을 캡처합니다. 각 데이터 포인트는 사람의 총 체지방을 총 체질량 대비 백분율로 나타냅니다.

REST

이름com.google.body.fat.percentage
OAuth 권한 범위
https://www.googleapis.com/auth/fitness.body.read
https://www.googleapis.com/auth/fitness.body.write
필드 (형식—단위) percentage (float: 퍼센트)
총 체질량 중 체지방의 비율입니다.
유효 범위: 0~100%

Android

이름com.google.body.fat.percentage
데이터 유형 객체TYPE_BODY_FAT_PERCENTAGE
필드 (형식—단위) FIELD_PERCENTAGE (float: 퍼센트)
총 체질량 중 체지방의 비율입니다.
유효 범위: 0~100%

체온

이 데이터 유형은 사용자의 체온을 캡처합니다. 각 데이터 포인트는 즉각적인 단일 체온 측정값을 나타냅니다.

REST

이름com.google.body.temperature
OAuth 권한 범위
https://www.googleapis.com/auth/fitness.body_temperature.read
https://www.googleapis.com/auth/fitness.body_temperature.write
필드 (형식—단위)
체온 (float—섭씨)
체온(섭씨)입니다.
측정 위치 (int: 열거형) (선택적 필드)
사용자의 신체에서 체온을 측정한 위치입니다.

Android

이름com.google.body.temperature
데이터 유형 객체TYPE_BODY_TEMPERATURE
필드 (형식—단위)
FIELD_BODY_TEMPERATURE (float—섭씨)
체온(섭씨)입니다.
FIELD_BODY_TEMPERATURE_MEASUREMENT_LOCATION (int—열거형) (선택적 입력란)
사용자의 신체에서 체온을 측정한 위치입니다.

자궁경관 점액

이 데이터 유형은 자궁경부점액에 대한 설명을 캡처합니다. 각 데이터 포인트는 사용자의 자궁경관 점액에 대한 자체 평가 설명을 나타냅니다. 모든 필드는 선택사항이며 자궁경부점액의 모양과 느낌과 양을 설명하는 데 사용할 수 있습니다.

REST

이름com.google.cervical_mucus
OAuth 권한 범위
https://www.googleapis.com/auth/fitness.reproductive_health.read
https://www.googleapis.com/auth/fitness.reproductive_health.write
필드 (형식—단위)
자궁경부점액 질감 (int—열거형) (선택적 입력란)
사용자 자궁경부 점액의 농도 또는 질감입니다.
자궁경관 점액 양 (int—열거형) (선택적 입력란)
사용자가 관찰하는 자궁경부점액의 양입니다.

Android

이름com.google.cervical_mucus
데이터 유형 객체TYPE_CERVICAL_MUCUS
필드 (형식—단위)
FIELD_CERVICAL_MUCUS_TEXTURE (int: 열거형) (선택 입력란)
사용자 자궁경부 점액의 농도 또는 질감입니다.
FIELD_CERVICAL_MUCUS_AMOUNT (int: 열거형) (선택 입력란)
사용자가 관찰하는 자궁경부점액의 양입니다.

경부 자세

이 데이터 유형에서 각 데이터 포인트는 사용자의 자궁 경부 보고서를 나타냅니다. 모든 필드는 선택사항이며, 자궁 경부의 위치, 확장, 경도에 대한 설명을 추가하는 데 사용할 수 있습니다.

REST

이름com.google.cervical_position
OAuth 권한 범위
https://www.googleapis.com/auth/fitness.reproductive_health.read
https://www.googleapis.com/auth/fitness.reproductive_health.write
필드 (형식—단위)
경부 위치 (int—열거형) (선택적 입력란)
사용자의 자궁경부 위치입니다.
자궁 경부 팽창 (int—열거형) (선택적 입력란)
사용자의 자궁경부가 얼마나 개방되거나 확장되었는지 여부
경부 경도 (int—열거형) (선택적 입력란)
사용자의 자궁경부가 얼마나 단단한지

Android

이름com.google.cervical_position
데이터 유형 객체TYPE_CERVICAL_POSITION
필드 (형식—단위)
FIELD_CERVICAL_POSITION (int—열거형) (선택적 필드)
사용자의 자궁경부 위치입니다.
FIELD_CERVICAL_DILATION (int: 열거형) (선택적 필드)
사용자의 자궁경부가 얼마나 개방되거나 확장되었는지 여부
FIELD_CERVICAL_FIRMNESS (int: 열거형) (선택적 필드)
사용자의 자궁경부가 얼마나 단단한지

심박수

이 데이터 유형은 사용자의 심박수를 분당 심박수로 캡처합니다. 각 데이터 포인트는 즉각적인 심박수 측정값을 나타내므로 종료 시간만 설정해야 합니다. 측정값의 타임스탬프로 사용됩니다.

REST

이름com.google.heart_rate.bpm
OAuth 권한 범위
https://www.googleapis.com/auth/fitness.heart_rate.read
https://www.googleapis.com/auth/fitness.heart_rate.write
필드 (형식—단위) bpm (float~bpm)
분당 심박수입니다.
유효 범위: 0~1000

Android

이름com.google.heart_rate.bpm
데이터 유형 객체TYPE_HEART_RATE_BPM
Android 권한녹음하려면 BODY_SENSORS하세요
필드 (형식—단위) bpm (float~bpm)
분당 심박수입니다.
유효 범위: 0~1,000bpm

이 데이터 유형은 사용자의 키를 미터 단위로 캡처합니다. 각 데이터 포인트는 판독 시 사용자의 키를 나타내므로 종료 시간만 설정해야 합니다. 측정값의 타임스탬프로 사용됩니다.

REST

이름com.google.height
OAuth 권한 범위
https://www.googleapis.com/auth/fitness.body.read
https://www.googleapis.com/auth/fitness.body.write
필드 (형식—단위) height (float—미터)
높이(미터)입니다.
유효 범위: 0~3미터

Android

이름com.google.height
데이터 유형 객체TYPE_HEIGHT
필드 (형식—단위) FIELD_HEIGHT (float—미터)
높이(미터)입니다.
유효 범위: 0~3미터

월경

이 데이터 유형은 사용자의 월경량(점혈, 약함, 중간 또는 무거움)에 대한 설명을 캡처합니다. 각 데이터 포인트는 사용자의 월경 출혈 양에 대한 설명을 나타냅니다.

REST

이름com.google.menstruation
OAuth 권한 범위
https://www.googleapis.com/auth/fitness.reproductive_health.read
https://www.googleapis.com/auth/fitness.reproductive_health.write
필드 (형식—단위)
월경 흐름 (int—열거형) (선택적 입력란)
사용자의 생리 기간입니다.

Android

이름com.google.menstruation
데이터 유형 객체TYPE_MENSTRUATION
필드 (형식—단위)
FIELD_MENSTRUAL_FLOW (int—열거형) (선택 입력란)
사용자의 생리 기간입니다.

배란 테스트

이 데이터 유형에서 각 데이터 포인트는 배란 테스트의 바이너리 결과 (양성 또는 음성)를 나타냅니다.

REST

이름com.google.ovulation_test
OAuth 권한 범위
https://www.googleapis.com/auth/fitness.reproductive_health.read
https://www.googleapis.com/auth/fitness.reproductive_health.write
필드 (형식—단위)
배란 테스트 (int—열거형) (선택사항)
배란 여부를 보여주는 사용자의 배란 테스트 결과입니다.

Android

이름com.google.ovulation_test
데이터 유형 객체TYPE_OVULATION_TEST
필드 (형식—단위)
FIELD_OVULATION_TEST_RESULT (int—열거형) (선택 입력란)
배란 여부를 보여주는 사용자의 배란 테스트 결과입니다.

산소 포화도

이 데이터 유형은 혈액에서 순환하는 산소의 양을 캡처하며, 산소 포화 헤모글로빈의 백분율로 측정됩니다. 각 데이터 포인트는 측정 시점의 단일 혈중 산소 포화도 측정값을 나타냅니다.

선택적 입력란을 사용하면 보충 산소량에 관한 세부정보도 추가할 수 있습니다(해당하는 경우).

REST

이름com.google.oxygen_saturation
OAuth 권한 범위
https://www.googleapis.com/auth/fitness.oxygen_saturation.read
https://www.googleapis.com/auth/fitness.oxygen_saturation.write
필드 (형식—단위)
산소 포화도 (float: 백분율)
혈중 산소 포화도(백분율)입니다.
유효 범위: 0~100%
보조 산소 유량 (float~L/min)
사용자에게 추가 산소가 공급되는 속도(분당 리터)입니다. 보충 산소가 제공되지 않고 사용자가 실내 공기만 호흡하고 있다면 0으로 설정합니다.
산소 요법 투여 모드 (int—열거형) (선택적 입력란)
산소 요법이 투여되는 방식
비강으로 투여하는 경우 결핍일 수 있으며 1합니다.
산소 포화도 시스템 (int—열거형) (선택적 입력란)
산소 포화도가 측정되는 위치입니다.
부재 또는 1일 수 있음(주변 모세 혈관에서 측정된 경우)
산소 포화도 측정 방법 (int: 열거형) (선택적 필드)
산소 포화도 측정 방법
맥박 산소 포화도로 측정한 경우 없거나 1일 수 있습니다.

Android

이름com.google.oxygen_saturation
데이터 유형 객체TYPE_OXYGEN_SATURATION
필드 (형식—단위)
FIELD_OXYGEN_SATURATION (float: 비율)
혈중 산소 포화도(백분율)입니다.
FIELD_SUPPLEMENTAL_OXYGEN_FLOW_RATE (float—L/분)
사용자에게 추가 산소가 공급되는 속도(분당 리터)입니다. 0은 보충 산소가 제공되지 않았으며 사용자가 실내 공기만 마시고 있음을 나타냅니다.
FIELD_OXYGEN_THERAPY_ADMINISTRATION_MODE (int—열거형) (선택 입력란)
산소 요법이 투여되는 방식
비강으로 투여하는 경우 결핍일 수 있으며 1합니다.
FIELD_OXYGEN_SATURATION_SYSTEM (int—열거형) (선택적 필드)
산소 포화도가 측정되는 위치입니다.
부재 또는 1일 수 있음(주변 모세 혈관에서 측정된 경우)
FIELD_OXYGEN_SATURATION_MEASUREMENT_METHOD (int: 열거형) (선택적 필드)
산소 포화도 측정 방법
맥박 산소 포화도로 측정한 경우 없거나 1일 수 있습니다.

절전 모드

이 데이터 유형은 사용자의 수면 시간과 유형을 캡처합니다. 각 데이터 포인트는 수면 단계의 시간 간격을 나타냅니다.

데이터 포인트의 시작 시간은 수면 단계의 시작을 나타내며 항상 포함되어야 합니다. 타임스탬프는 수면 단계의 종료를 나타냅니다. 시간 간격은 연속적일 필요는 없지만 겹쳐서는 안 됩니다.

REST

이름com.google.sleep.segment
OAuth 권한 범위
https://www.googleapis.com/auth/fitness.sleep.read
https://www.googleapis.com/auth/fitness.sleep.write
필드 (형식—단위) 수면 세그먼트 유형 (int—열거형)
다양한 수면 단계 및 유형을 나타내는 값입니다.

Android

이름com.google.sleep.segment
데이터 유형 객체TYPE_SLEEP_SEGMENT
필드 (형식—단위) FIELD_SLEEP_SEGMENT_TYPE (int—열거형)
다양한 수면 단계 및 유형을 나타내는 값입니다.

질 출혈

이 데이터 유형은 사용자에게 부정출혈 (생리 기간 사이에 출혈)이 발생하는 경우 캡처합니다. 각 데이터 포인트는 하나의 스팟팅 인스턴스를 나타내므로 각 포인트에는 타임스탬프가 있어야 하며 발생 횟수 필드는 1로 설정해야 합니다.

REST

이름com.google.vaginal_spotting
OAuth 권한 범위
https://www.googleapis.com/auth/fitness.reproductive_health.read
https://www.googleapis.com/auth/fitness.reproductive_health.write
필드 (형식—단위)
일치하는 항목 (int—개수)
각 스팟에 대한 조사입니다. 이 필드를 1으로 설정합니다.

Android

이름com.google.vaginal_spotting
데이터 유형 객체TYPE_VAGINAL_SPOTTING
필드 (형식—단위)
FIELD_OCCURRENCES (int—개수)
각 스팟에 대한 조사입니다. 이 필드를 1으로 설정합니다.

무게

이 데이터 유형은 사용자의 체중을 킬로그램으로 캡처합니다. 각 데이터 포인트는 측정 시점의 사용자 몸무게를 나타내므로 종료 시간만 설정해야 합니다. 측정값의 타임스탬프로 사용됩니다.

REST

이름com.google.weight
OAuth 권한 범위
https://www.googleapis.com/auth/fitness.body.read
https://www.googleapis.com/auth/fitness.body.write
필드 (형식—단위) 무게 (float—kg)
체중(킬로그램)입니다.
유효 범위: 0~1,000킬로그램

Android

이름com.google.weight
데이터 유형 객체TYPE_WEIGHT
필드 (형식—단위) FIELD_WEIGHT (float—kg)
체중(킬로그램)입니다.
유효 범위: 0~1,000킬로그램

건강 데이터 읽기 및 쓰기 권한 가져오기

건강 데이터를 읽으려면 다음 단계를 따르세요.

  1. 앱이 Google의 API 사용자 데이터 정책과 Google 피트니스 개발자 및 사용자 데이터 정책을 준수하는지 확인합니다.
  2. 동의 화면을 신청하여 Google에서 확인합니다.

앱이 인증되면 사용자가 읽는 데 동의한 건강 데이터를 읽을 수 있습니다.