건강 데이터 유형

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)
혈당 수치 또는 농도(mmol/L)를 의미하며, 여기서 1mmol/L은 18mg/dL입니다.
시간적 식사와의 관계(int—enum) (선택사항 필드)
사용자가 식사를 한 시점과 비교하여 측정한 시점입니다.
식사 유형 (int—enum) (선택사항 필드)
측정값을 측정할 때 사용자가 먹은 식사 유형입니다.
시간 간 관계 (int—enum) (선택사항 필드)
사용자가 측정한 시간과 읽기를 수행한 시간을 비교합니다.
시료 소스 (int—enum) (선택사항)
혈당을 측정하는 데 사용되는 체액의 유형입니다.

Android

이름com.google.blood_glucose
데이터 유형 객체TYPE_BLOOD_GLUCOSE
필드 (형식: 단위)
FIELD_BLOOD_GLUCOSE_LEVEL (float—mmol/L)
혈당 수치 또는 농도(mmol/L)를 의미하며, 여기서 1mmol/L은 18mg/dL입니다.
FIELD_TEMPORAL_RELATION_TO_MEAL (int—enum) (선택사항 필드)
사용자가 식사를 한 시점과 비교하여 측정한 시점입니다.
FIELD_MEAL_TYPE (int—열거형) (선택사항 필드)
측정값을 측정할 때 사용자가 먹은 식사 유형입니다.
FIELD_TEMPORAL_RELATION_TO_SLEEP(int—enum) (선택사항 필드)
사용자가 측정한 시간과 읽기를 수행한 시간을 비교합니다.
FIELD_BLOOD_GLUCOSE_SPECIMEN_SOURCE (int—enum) (선택사항 필드)
혈당을 측정하는 데 사용되는 체액의 유형입니다.

혈압

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

REST

이름com.google.blood_pressure
OAuth 권한 범위
https://www.googleapis.com/auth/fitness.blood_pressure.read
https://www.googleapis.com/auth/fitness.blood_pressure.write
필드 (형식: 단위)
systolic (float—mmHg)
수축기 혈압 측정.
이완기 (float—mmHg)
이완기 혈압 측정값.
본문 위치 (int—enum) (선택사항 필드)
측정한 사용자의 신체 위치입니다.
측정 위치(int—enum) (선택사항 필드)
측정된 부문과 부문

Android

이름com.google.blood_pressure
데이터 유형 객체TYPE_BLOOD_PRESSURE
필드 (형식: 단위)
FIELD_BLOOD_PRESSURE_SYSTOLIC(float—mmHg)
수축기 혈압 측정.
FIELD_BLOOD_PRESSURE_DIASTOLIC (float—mmHg)
이완기 혈압 측정값.
FIELD_BODY_Position (int—enum) (선택사항)
측정한 사용자의 신체 위치입니다.
FIELD_BLOOD_PRESSURE_MEASUREMENT_LOCATION (int—enum) (선택사항 필드)
측정된 부문과 부문

체지방률

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

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—percent)
체지방인 총 질량의 비율입니다.
유효한 범위: 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—enum) (선택사항 필드)
사용자의 체온을 측정한 장소입니다.

Android

이름com.google.body.temperature
데이터 유형 객체TYPE_BODY_TEMPERATURE
필드 (형식: 단위)
FIELD_BODY_TEMPERATURE(float: 섭씨)
섭씨 온도입니다.
FIELD_BODY_TEMPERATURE_MEASUREMENT_LOCATION (int—enum) (선택사항)
사용자의 체온을 측정한 장소입니다.

자궁경관 점액

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

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—enum) (선택사항)
사용자의 자궁경관 점액의 농도 또는 질감입니다.
자궁경관 점액 (int—enum) (선택사항)
사용자가 관찰하는 자궁경관 점액의 양

Android

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

경부 자세

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

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—enum) (선택사항)
사용자의 자궁경부의 위치입니다.
경부 확장 (int—enum) (선택사항 필드)
사용자의 자궁 경부가 얼마나 열리거나 확장되었는지를 나타냅니다.
경부 견고성 (int—enum) (선택사항 필드)
사용자의 자궁 경부 건강 상태

Android

이름com.google.cervical_position
데이터 유형 객체TYPE_CERVICAL_Position
필드 (형식: 단위)
FIELD_CERVICAL_Position (int—enum) (선택사항 필드)
사용자의 자궁경부의 위치입니다.
FIELD_CERVICAL_DILATION(int—enum) (선택사항 필드)
사용자의 자궁 경부가 얼마나 열리거나 확장되었는지를 나타냅니다.
FIELD_CERVICAL_FIRMNESS (int—enum) (선택사항)
사용자의 자궁경부 함량

심박수

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

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~1000bpm

높이

이 데이터 유형은 사용자의 높이를 미터로 캡처합니다. 각 데이터 포인트는 읽을 때의 사용자 높이를 나타내므로 종료 시간만 설정해야 합니다. 읽음의 타임스탬프로 사용됩니다.

REST

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

Android

이름com.google.height
데이터 유형 객체TYPE_HEIGHT
필드 (형식: 단위) FIELD_HEIGHT(float—미터)
높이(m)입니다.
유효한 범위: 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—enum) (선택사항)
사용자의 생리 기간.

Android

이름com.google.menstruation
데이터 유형 객체TYPE_MENSTRUATION
필드 (형식: 단위)
FIELD_MENSTRUAL_FLOW (int—enum) (선택사항 필드)
사용자의 생리 기간.

배란 테스트

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

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—enum) (선택사항 필드)
사용자의 배란 여부를 보여주는 배란 테스트 결과입니다.

Android

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

산소 포화도

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

선택 필드를 사용하면 관리 산소를 공급하는 경우 보충 산소에 대한 세부정보를 추가할 수 있습니다.

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/분)
추가 산소가 분당 리터 단위로 사용자에게 제공되는 속도입니다. 추가 산소가 제공되지 않고 사용자가 환기실만 사용할 수 있는 경우 0으로 설정하세요.
산소 요법 관리 모드(int—enum) (선택사항)
산소 요법 투여 방법
결막에 존재할 수 없으며 비강 캐닐라로 투여하는 경우 1일 수 있습니다.
산소 포화도 시스템 (int—enum) (선택사항)
산소 포화도가 측정되는 위치입니다.
주변기기에 있는 경우 측정되지 않거나 1일 수 있습니다.
산소 포화도 측정 방법 (int—enum) (선택사항 필드)
산소 포화도 측정 방법.
결석이거나, 맥박 산소 농도에 따라 측정되면 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—enum) (선택사항 필드)
산소 요법 투여 방법
결막에 존재할 수 없으며 비강 캐닐라로 투여하는 경우 1일 수 있습니다.
FIELD_OXYGEN_SATURATION_SYSTEM(int—enum) (선택사항 필드)
산소 포화도가 측정되는 위치입니다.
주변기기에 있는 경우 측정되지 않거나 1일 수 있습니다.
FIELD_OXYGEN_SATURATION_MEASUREMENT_Method(int—enum) (선택사항 필드)
산소 포화도 측정 방법.
결석이거나, 맥박 산소 농도에 따라 측정되면 1일 수 있습니다.

수면

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

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

REST

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

Android

이름com.google.sleep.segment
데이터 유형 객체TYPE_SLEEP_SEGMENT
필드 (형식: 단위) FIELD_SLEEP_세그먼트_유형(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
데이터 유형 객체VA_INAL_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
필드 (형식: 단위) weight (float~kgs)
몸무게(킬로그램)
유효한 범위: 0~1000킬로그램

Android

이름com.google.weight
데이터 유형 객체TYPE_WEIGHT
필드 (형식: 단위) FIELD_WEIGHT (float~kgs)
몸무게(킬로그램)
유효한 범위: 0~1000킬로그램

건강 데이터 읽기 및 쓰기 권한 얻기

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

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

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