2025년 6월 30일 이후에는 Google 피트니스 REST API를 포함한 Google 피트니스 API를 더 이상 사용할 수 없습니다. 2024년 5월 1일부터 개발자는 이 API를 사용하기 위해 가입할 수 없습니다.

이전할 API 또는 플랫폼에 관한 안내는 헬스 커넥트 이전 가이드를 참고하세요. 헬스 커넥트와 Google 피트니스 API 및 Fitbit Web API를 비교하려면 헬스 커넥트 비교 가이드를 참고하세요.

헬스 커넥트 및 API와 통합하는 방법을 자세히 알아보세요.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

집계 데이터 유형

일정 기간 동안 여러 데이터 포인트를 사용하여 지속적으로 기록할 수 있는 데이터의 경우 Google 피트니스 플랫폼에서 이 데이터를 집계하고 계산된 결과를 반환할 수 있습니다. 평균 측정값일 수도 있고 요약/총계일 수도 있습니다. 집계된 데이터를 읽어 이러한 계산 시간을 절약하고 앱 사용자에게 유용한 요약이나 평균을 쉽게 보여줄 수 있습니다.

집계된 데이터를 읽으려면 데이터 유형, 기간, 데이터를 '버킷' (또는 그룹화)할 기준을 선택해야 합니다. 다음과 같은 몇 가지 방법으로 데이터를 버케팅할 수 있습니다.

기간: 집계 데이터를 시간 또는 일별로 버케팅합니다. 예를 들어 일일 걸음 수나 칼로리 소모량을 확인할 수 있습니다.
활동 유형: 활동 유형별로 합산 데이터 버케팅 예를 들어, 한 주 동안의 수면 데이터는 수면 활동 유형 (얕은 수면, 깊은 수면, 렘 수면)별로 버킷이 있습니다.
활동 세그먼트: 일정 기간 동안 활동 세그먼트별로 집계된 데이터를 버케팅합니다. 예를 들어 사용자가 오전 9시에서 오전 10시 사이에 달리기를 시작했으나 처음 20분 동안 실행했고 10분 동안 앉아서 15분 동안 걷고 15분 동안 실행했다면 이는 4개의 활동 세그먼트로 간주되며 4개의 버킷을 반환합니다.
세션: 세션의 시간 경계를 사용해 데이터를 집계합니다. 예를 들어 사용자가 2번의 달리기를 했고 2번의 세션 (아침 달리기 및 오후 달리기)으로 기록되었다면 세션별로 버킷을 분류하여 각 달리기의 평균 걸음 수 또는 평균 속도를 알아볼 수 있습니다.

활동

집계된 건강 및 웰니스 데이터를 읽으려면 이러한 데이터 유형을 사용하세요.

활동 요약

일정 기간 동안 특정 활동에 대한 총 시간 및 세그먼트 수입니다. 각 데이터 포인트는 시간 간격 동안 특정 활동 유형에 관한 모든 활동 세그먼트의 요약을 나타냅니다.

REST

이름 com.google.activity.summary

OAuth 권한 범위

https://www.googleapis.com/auth/fitness.activity.read

필드 (형식—단위)

activity (int—열거형)

사용자가 진행 중인 활동의 유형. 활동 유형 목록은 여기를 참고하세요.

duration (int—밀리초)

시간 범위의 모든 세그먼트에서 특정 활동에 소비된 총 시간입니다.

세그먼트 수 (int—개수)

이 데이터 포인트의 시간 간격 동안의 고유한 활동 세그먼트 수입니다.

Android

이름 com.google.activity.summary

데이터 유형 객체 AGGREGATE_ACTIVITY_SUMMARY

필드 (형식—단위)

FIELD_ACTIVITY (int—열거형)

사용자가 진행 중인 활동의 유형. 활동 유형 목록은 여기를 참고하세요.

FIELD_DURATION (int—밀리초)

시간 범위의 모든 세그먼트에서 특정 활동에 소비된 총 시간입니다.

FIELD_NUM_SEGMENTS (int: 개수)

이 데이터 포인트의 시간 간격 동안의 고유한 활동 세그먼트 수입니다.

기초대사율 (BMR) 요약

각 데이터 포인트는 해당 기간 동안의 사용자의 평균, 최대, 최소 기초 대사율을 일일 킬로칼로리 단위로 나타냅니다. 이는 사용자의 체중이 증가하거나 감소하여 BMR이 변경된 경우에 유용합니다.

REST

이름 com.google.calories.bmr.summary

OAuth 권한 범위

https://www.googleapis.com/auth/fitness.activity.read

필드 (형식—단위)

평균 (float—일일 kcal)

일정 기간 동안의 사용자 평균 BMR입니다.

max (float~kcal/일)

특정 기간 동안 사용자의 최대 BMR입니다.

min (float—kcal/일)

특정 기간 동안의 사용자 최소 BMR입니다.

Android

이름 com.google.calories.bmr.summary

데이터 유형 객체 AGGREGATE_BASAL_METABOLIC_RATE_SUMMARY

필드 (형식—단위)

FIELD_AVERAGE (float—kcal/일)

일정 기간 동안의 사용자 평균 BMR입니다.

FIELD_MAX (float—kcal/일)

특정 기간 동안 사용자의 최대 BMR입니다.

FIELD_MIN (float—일일 kcal)

특정 기간 동안의 사용자 최소 BMR입니다.

칼로리 소모량 요약

일정 기간 동안의 집계 또는 총 칼로리 소모량(킬로칼로리)입니다. 이 데이터 유형 및 필드는 순간 데이터 유형과 동일합니다.

심장 강화 점수 요약

각 데이터 포인트는 특정 기간에 획득한 심장 강화 점수의 수를 나타냅니다.

REST

이름 com.google.heart_minutes.summary

OAuth 권한 범위

https://www.googleapis.com/auth/fitness.activity.read

필드 (형식—단위)

inintity (float: 심장 강화 점수)

일정 기간 동안 획득한 심장 강화 점수입니다. 여기에는 승수 (높은 강도 높은 활동을 하면 더 많은 포인트 획득)로 획득한 포인트가 포함됩니다.

duration (float—분)

분 단위로 측정된 심장 강화 점수를 획득한 시간입니다.

Android

이름 com.google.heart_minutes.summary

데이터 유형 객체 AGGREGATE_HEART_POINTS

필드 (형식—단위)

FIELD_INTENSITY (float: 심장 강화 점수)

일정 기간 동안 획득한 심장 강화 점수입니다. 여기에는 승수 (높은 강도 높은 활동을 하면 더 많은 포인트 획득)로 획득한 포인트가 포함됩니다.

FIELD_DURATION (float—분)

분 단위로 측정된 심장 강화 점수를 획득한 시간입니다.

운동 시간 요약

기간 동안의 총 이동 시간(분)입니다. 이 데이터 유형 및 필드는 순간 데이터 유형과 동일합니다.

전원 요약

각 데이터 포인트는 일정 기간 동안 생성된 사용자의 평균, 최대, 최소 전력을 와트 단위로 나타냅니다.

REST

이름 com.google.power.summary

OAuth 권한 범위

https://www.googleapis.com/auth/fitness.activity.read

필드 (형식—단위)

평균 (float—와트)

해당 기간 동안 생성된 사용자의 평균 전력(와트 단위)입니다.

max (float—와트)

해당 기간 동안 생성된 사용자의 최대 전력(와트 단위)입니다.

min (float—와트)

해당 기간 동안 생성된 사용자의 최소 전력(와트 단위)입니다.

Android

이름 com.google.power.summary

데이터 유형 객체 AGGREGATE_POWER_SUMMARY

필드 (형식—단위)

FIELD_AVERAGE (float—와트)

해당 기간 동안 생성된 사용자의 평균 전력(와트 단위)입니다.

FIELD_MAX (float—와트)

해당 기간 동안 생성된 사용자의 최대 전력(와트 단위)입니다.

FIELD_MIN (float—와트)

해당 기간 동안 생성된 사용자의 최소 전력(와트 단위)입니다.

걸음 수 델타 요약

각 데이터 포인트는 기간 동안의 총 걸음 수를 나타냅니다. 이 데이터 유형 및 필드는 순간 데이터 유형과 동일합니다.

본문

집계된 신체 측정 데이터를 읽으려면 이 데이터 유형을 사용하세요.

체지방률 요약

각 데이터 포인트는 일정 기간 동안의 사용자의 평균, 최대, 최소 체지방률을 나타냅니다.

REST

이름 com.google.body.fat.percentage.summary

OAuth 권한 범위

https://www.googleapis.com/auth/fitness.body.read

필드 (형식—단위)

평균 (float: 퍼센트)

일정 기간 동안 사용자의 전체 체지방률 평균 백분율입니다.

max (float: 백분율)

일정 기간 동안 사용자의 총 체질량 중 체지방률 최대 비율입니다.

min (float: 퍼센트)

일정 기간 동안 사용자의 총 체질량 중 체지방률의 최소 비율입니다.

Android

이름 com.google.body.fat.percentage.summary

데이터 유형 객체 AGGREGATE_BODY_FAT_PERCENTAGE_SUMMARY

필드 (형식—단위)

FIELD_AVERAGE (float: 백분율)

일정 기간 동안 사용자의 전체 체지방률 평균 백분율입니다.

FIELD_MAX (float: 백분율)

일정 기간 동안 사용자의 총 체질량 중 체지방률 최대 비율입니다.

FIELD_MIN (float: 퍼센트)

일정 기간 동안 사용자의 총 체질량 중 체지방률의 최소 비율입니다.

심박수 요약

각 데이터 포인트는 해당 기간 동안의 사용자 평균, 최대, 최소 심박수를 분당 심박수로 나타냅니다.

REST

이름 com.google.heart_rate.summary

OAuth 권한 범위

https://www.googleapis.com/auth/fitness.body.read

필드 (형식—단위)

평균 (float—bpm)

일정 기간 동안의 분당 심박수로 사용자의 평균 심박수입니다.

max (float~bpm)

일정 기간 동안 사용자의 최대 심박수(분당 심박수)입니다.

min (float~bpm)

일정 기간 동안 사용자의 최소 심박수(분당 심박수)입니다.

Android

이름 com.google.heart_rate.summary

데이터 유형 객체 AGGREGATE_HEART_RATE_SUMMARY

필드 (형식—단위)

FIELD_AVERAGE (float~bpm)

일정 기간 동안의 분당 심박수로 사용자의 평균 심박수입니다.

FIELD_MAX (float~bpm)

일정 기간 동안 사용자의 최대 심박수(분당 심박수)입니다.

FIELD_MIN (float~bpm)

일정 기간 동안 사용자의 최소 심박수(분당 심박수)입니다.

높이 요약

각 데이터 포인트는 일정 기간 동안의 사용자의 평균, 최대, 최소 신장을 미터 단위로 나타냅니다.

REST

이름 com.google.height.summary

OAuth 권한 범위

https://www.googleapis.com/auth/fitness.body.read

필드 (형식—단위)

평균 (float—미터)

일정 기간 동안의 사용자의 평균 신장(미터)입니다.

max (float—미터)

일정 기간 동안의 사용자 최대 신장(미터)입니다.

min (float—미터)

일정 기간 동안의 사용자의 최소 신장(미터)입니다.

Android

이름 com.google.height.summary

데이터 유형 객체 AGGREGATE_HEIGHT_SUMMARY

필드 (형식—단위)

FIELD_AVERAGE (float—미터)

일정 기간 동안의 사용자의 평균 신장(미터)입니다.

FIELD_MAX (float—미터)

일정 기간 동안의 사용자 최대 신장(미터)입니다.

FIELD_MIN (float—미터)

일정 기간 동안의 사용자의 최소 신장(미터)입니다.

가중치 요약

각 데이터 포인트는 일정 기간 동안의 사용자의 평균, 최대, 최소 체중을 킬로그램 단위로 나타냅니다.

REST

이름 com.google.weight.summary

OAuth 권한 범위

https://www.googleapis.com/auth/fitness.body.read

필드 (형식—단위)

평균 (float—kg)

일정 기간 동안의 사용자의 평균 체중(킬로그램)입니다.

max (float—kg)

특정 기간 동안 사용자의 최대 체중(킬로그램)입니다.

min (float—kg)

일정 기간 동안의 사용자의 최소 체중(킬로그램)입니다.

Android

이름 com.google.weight.summary

데이터 유형 객체 AGGREGATE_WEIGHT_SUMMARY

필드 (형식—단위)

FIELD_AVERAGE (float—kg)

일정 기간 동안의 사용자의 평균 체중(킬로그램)입니다.

FIELD_MAX (float—kg)

특정 기간 동안 사용자의 최대 체중(킬로그램)입니다.

FIELD_MIN (float—kg)

일정 기간 동안의 사용자의 최소 체중(킬로그램)입니다.

위치

집계된 위치 데이터를 읽으려면 이러한 데이터 유형을 사용합니다.

거리 델타

각 데이터 포인트는 특정 기간 동안 사용자의 총 이동 거리를 미터 단위로 나타냅니다. 이 데이터 유형과 해당 필드는 순간 데이터 유형과 동일합니다.

위치 경계 상자

각 데이터 포인트는 일정 기간 동안 사용자의 위치 포인트에 대해 계산된 경계 상자를 나타냅니다. 각 경계 상자에는 경계 상자의 네 모서리를 나타내는 네 개의 필드가 있습니다.

REST

이름 com.google.location.bounding_box

OAuth 권한 범위

https://www.googleapis.com/auth/fitness.location.read

필드 (형식—단위)

낮은 위도 (float—도)

부동 소수점으로 표시되는 경계 상자의 최소 위도(도)입니다.

낮은 경도 (float—도)

경계 상자의 최소 경도(부동 소수점 수로 도 단위)입니다.

고위도 (float—도)

부동 소수점으로 표시되는 경계 상자의 최대 위도(단위: 도)입니다.

높은 경도 (float—도)

부동 소수점으로 표시되는 경계 상자의 최대 경도(단위: 도)입니다.

Android

이름 com.google.location.bounding_box

데이터 유형 객체 AGGREGATE_LOCATION_BOUNDING_BOX

필드 (형식—단위)

FIELD_LOW_LATITUDE (float—도)

경계 상자의 왼쪽 하단 모서리의 위도로, 부동 소수점 수로 표시됩니다(단위: 도).

FIELD_LOW_LONGITUDE (float—도)

경계 상자 왼쪽 하단 모서리의 경도(부동 소수점 수로 도 단위)입니다.

FIELD_HIGH_LATITUDE (float—도)

경계 상자의 오른쪽 상단 모서리의 위도로, 부동 소수점 수로 표시됩니다(단위: 도).

FIELD_HIGH_LONGITUDE (float—도)

경계 상자 오른쪽 상단 모서리의 경도(부동 소수점 수로 도 단위)입니다.

속도 요약

각 데이터 포인트는 사용자가 일정 기간 동안 이동한 평균, 최대, 최저 속도를 초당 미터 단위로 나타냅니다.

REST

이름 com.google.speed.summary

OAuth 권한 범위

https://www.googleapis.com/auth/fitness.location.read

필드 (형식—단위)

평균 (float: 초당 미터)

특정 기간 동안의 사용자 평균 속도(초당 미터)입니다.

max (float: 초당 미터)

특정 기간 동안의 사용자 최대 속도(초당 미터)입니다.

min (float: 초당 미터)

특정 기간 동안의 사용자 최저 속도(초당 미터)입니다.

Android

이름 com.google.speed.summary

데이터 유형 객체 AGGREGATE_SPEED_SUMMARY

필드 (형식—단위)

평균 (float: 초당 미터)

특정 기간 동안의 사용자 평균 속도(초당 미터)입니다.

max (float: 초당 미터)

특정 기간 동안의 사용자 최대 속도(초당 미터)입니다.

min (float: 초당 미터)

특정 기간 동안의 사용자 최저 속도(초당 미터)입니다.

영양

집계된 영양 데이터를 읽으려면 이 데이터 유형을 사용합니다.

수분 섭취 요약

각 데이터 포인트는 일정 기간 동안 사용자가 소비한 물의 총량을 리터 단위로 나타냅니다. 이 데이터 유형과 해당 필드는 순간 데이터 유형과 동일합니다.

영양 요약

각 데이터 포인트는 일정 기간 동안 모든 영양 항목의 합계를 나타냅니다. 영양소 필드에서 각 값은 기간의 모든 항목에 대한 영양소의 합계를 나타냅니다.

어떤 항목에도 영양소가 포함되어 있지 않으면 집계 맵에도 영양소가 포함되지 않습니다. 이 기간의 모든 항목이 동일한 식사에 관한 것이면 식사 유형도 설정됩니다.

REST

이름 com.google.nutrition.summary

OAuth 권한 범위

https://www.googleapis.com/auth/fitness.nutrition.read

필드 (형식—단위)

식사 유형 (int—열거형)

사용자가 식사한 음식 (해당 기간의 모든 항목이 동일한 식사에 해당하는 경우 표시됨)

허용되는 값

"intVal": 1 // Unknown
"intVal": 2 // Breakfast
"intVal": 3 // Lunch
"intVal": 4 // Dinner
"intVal": 5 // Snack

영양소 (Map<String>—칼로리/그램)

일정 기간 동안 섭취한 음식의 총 영양소입니다.

허용되는 값

"key": "calories" // Calories in kcal
"key": "fat.total" // Total fat in grams
"key": "fat.saturated" // Saturated fat in grams
"key": "fat.unsaturated" // Unsaturated fat in grams
"key": "fat.polyunsaturated" // Polyunsaturated fat in grams
"key": "fat.monounsaturated" // Monounsaturated fat in grams
"key": "fat.trans" // Trans fat in grams
"key": "cholesterol" // Cholesterol in milligrams
"key": "sodium" // Sodium in milligrams
"key": "potassium" // Potassium in milligrams
"key": "carbs.total" // Total carbohydrates in grams
"key": "dietary_fiber" //  Dietary fiber in grams
"key": "sugar" // Amount of sugar in grams
"key": "protein" // Protein amount in grams

Android

이름 com.google.nutrition.summary

데이터 유형 객체 AGGREGATE_NUTRITION_SUMMARY

필드 (형식—단위)

FIELD_MEAL_TYPE (int—열거형)

사용자가 식사한 음식 (해당 기간의 모든 항목이 동일한 식사에 해당하는 경우 표시됨)

허용되는 값

MEAL_TYPE_UNKNOWN // Unknown
MEAL_TYPE_BREAKFAST // Breakfast
MEAL_TYPE_LUNCH // Lunch
MEAL_TYPE_DINNER // Dinner
MEAL_TYPE_SNACK // Snack

FIELD_NUTRIENTS (Map<String>—킬로칼로리/그램/밀리그램)

일정 기간 동안 섭취한 음식의 총 영양소입니다.

허용되는 값

NUTRIENT_CALORIES // Calories in kcal
NUTRIENT_TOTAL_FAT // Total fat in grams
NUTRIENT_SATURATED_FAT // Saturated fat in grams
NUTRIENT_UNSATURATED_FAT // Unsaturated fat in grams
NUTRIENT_POLYUNSATURATED_FAT // Polyunsaturated fat in grams
NUTRIENT_MONOUNSATURATED_FAT // Monounsaturated fat in grams
NUTRIENT_TRANS_FAT // Trans fat in grams
NUTRIENT_CHOLESTEROL // Cholesterol in milligrams
NUTRIENT_SODIUM // Sodium in milligrams
NUTRIENT_POTASSIUM // Potassium in milligrams
NUTRIENT_TOTAL_CARBS // Total carbohydrates in grams
NUTRIENT_DIETARY_FIBER //  Dietary fiber in grams
NUTRIENT_SUGAR // Amount of sugar in grams
NUTRIENT_PROTEIN // Protein amount in grams

건강

집계된 의료, 건강 데이터를 읽으려면 이러한 데이터 유형을 사용하세요.

혈당 요약

각 데이터 포인트는 기간 동안의 평균, 최소, 최대 혈당 수치 또는 농도를 mmol/L로 측정하며 1mmol/L은 18mg/dL입니다.

이러한 각 필드의 값이 해당 기간 동안 측정된 모든 측정의 값이 같으면 반환된 데이터에 필드 값이 표시됩니다.

식사와의 시간적 관계
수면과의 시간적 관계
표본 소스

측정값에서 값이 다르면 해당 필드는 제외됩니다.

REST

이름 com.google.blood_glucose.summary

OAuth 권한 범위

https://www.googleapis.com/auth/fitness.blood_glucose.read

필드 (형식—단위)

평균 (float—mmol/L)

일정 기간 동안의 사용자의 평균 혈당 수준 또는 농도입니다.

max (float~mmol/L)

일정 기간 동안의 사용자의 최대 혈당 수준 또는 농도입니다.

min (float—mmol/L)

일정 기간 동안의 사용자의 최소 혈당 수준 또는 농도입니다.

식사와의 시간적 관계 (int—열거형) (선택적 필드)

사용자가 식사할 때와 비교하여 읽은 시간입니다.

허용되는 값

"intVal": 1 // Reading wasn't taken before or after a meal
"intVal": 2 // Reading was taken during a fasting period
"intVal": 3 // Reading was taken before a meal
"intVal": 4 // Reading was taken after a meal

meal type (int—열거형) (선택 필드)

측정값을 구할 때 사용자가 먹은 식사 유형입니다.

허용되는 값

"intVal": 1 // Unknown
"intVal": 2 // Breakfast
"intVal": 3 // Lunch
"intVal": 4 // Dinner
"intVal": 5 // Snack

수면과의 시간 관계 (int—열거형) (선택적 필드)

사용자가 수면을 취한 시간과 비교하여 측정값을 구한 시간입니다.

허용되는 값

"intVal": 1 // User was fully awake
"intVal": 2 // Before the user fell asleep
"intVal": 3 // After the user woke up
"intVal": 4 // While the user was still sleeping

표본 소스 (int—열거형) (선택적 필드)

혈당 측정에 사용되는 체액 유형입니다.

허용되는 값

"intVal": 1 // Interstitial fluid
"intVal": 2 // Capillary blood
"intVal": 3 // Plasma
"intVal": 4 // Serum
"intVal": 5 // Tears
"intVal": 6 // Whole blood

Android

이름 com.google.blood_glucose.summary

데이터 유형 객체 AGGREGATE_BLOOD_GLUCOSE_SUMMARY

필드 (형식—단위)

FIELD_AVERAGE (float—mmol/L)

일정 기간 동안의 사용자의 평균 혈당 수준 또는 농도입니다.

FIELD_MAX (float—mmol/L)

일정 기간 동안의 사용자의 최대 혈당 수준 또는 농도입니다.

FIELD_MIN (float—mmol/L)

일정 기간 동안의 사용자의 최소 혈당 수준 또는 농도입니다.

FIELD_TEMPORAL_RELATION_TO_MEAL (int—열거형) (선택적 입력란)

사용자가 식사할 때와 비교하여 읽은 시간입니다.

허용되는 값

FIELD_TEMPORAL_RELATION_TO_MEAL_GENERAL // Reading wasn't taken before or after a meal
FIELD_TEMPORAL_RELATION_TO_MEAL_FASTING // Reading was taken during a fasting period
FIELD_TEMPORAL_RELATION_TO_MEAL_BEFORE_MEAL // Reading was taken before a meal
FIELD_TEMPORAL_RELATION_TO_MEAL_AFTER_MEAL // Reading was taken after a meal

FIELD_MEAL_TYPE (int—열거형) (선택적 입력란)

측정값을 구할 때 사용자가 먹은 식사 유형입니다.

허용되는 값

MEAL_TYPE_UNKNOWN // Unknown
MEAL_TYPE_BREAKFAST // Breakfast
MEAL_TYPE_LUNCH // Lunch
MEAL_TYPE_DINNER // Dinner
MEAL_TYPE_SNACK // Snack

FIELD_TEMPORAL_RELATION_TO_SLEEP (int—열거형) (선택적 필드)

사용자가 수면을 취한 시간과 비교하여 측정값을 구한 시간입니다.

허용되는 값

TEMPORAL_RELATION_TO_SLEEP_FULLY_AWAKE // User was fully awake.
TEMPORAL_RELATION_TO_SLEEP_BEFORE_SLEEP // Before the user fell asleep.
TEMPORAL_RELATION_TO_SLEEP_ON_WAKING // After the user woke up.
TEMPORAL_RELATION_TO_SLEEP_DURING_SLEEP // While the user was still sleeping.

FIELD_BLOOD_GLUCOSE_SPECIMEN_SOURCE (int—열거형) (선택 입력란)

혈당 측정에 사용되는 체액 유형입니다.

허용되는 값

BLOOD_GLUCOSE_SPECIMEN_SOURCE_INTERSTITIAL_FLUID // Interstitial fluid
BLOOD_GLUCOSE_SPECIMEN_SOURCE_CAPILLARY_BLOOD // Capillary blood
BLOOD_GLUCOSE_SPECIMEN_SOURCE_PLASMA // Plasma
BLOOD_GLUCOSE_SPECIMEN_SOURCE_SERUM // Serum
BLOOD_GLUCOSE_SPECIMEN_SOURCE_TEARS // Tears
BLOOD_GLUCOSE_SPECIMEN_SOURCE_WHOLE_BLOOD // Whole blood

혈압 요약

각 데이터 포인트는 mmHg 단위로 측정된 기간 동안의 평균, 최소, 최대 혈압을 나타냅니다.

이러한 각 필드의 값이 해당 기간 동안 측정된 모든 측정의 값이 같으면 반환된 데이터에 필드 값이 표시됩니다.

자세
측정 위치

측정값에서 값이 다르면 해당 필드는 제외됩니다.

REST

이름 com.google.blood_pressure.summary

OAuth 권한 범위

https://www.googleapis.com/auth/fitness.blood_pressure.read

필드 (형식—단위)

평균 수축기 (float—mmHg)

일정 기간 동안의 사용자의 평균 수축기 혈압입니다.

최대 수축기 (float—mmHg)

일정 기간 동안의 사용자의 최대 수축기 혈압입니다.

분 수축기 (float—mmHg)

일정 기간 동안 사용자의 최소 수축기 혈압입니다.

평균 확장기 (float—mmHg)

일정 기간 동안의 사용자의 평균 확장기 혈압입니다.

최대 확장기 (float—mmHg)

일정 기간 동안의 사용자의 최대 확장기 혈압입니다.

최소 확장기 (float—mmHg)

일정 기간 동안 사용자의 최소 확장기 혈압입니다.

body position (int—enum) (선택적 필드)

측정값이 측정된 사용자의 신체 위치입니다.

허용되는 값

"intVal": 1 // Standing up
"intVal": 2 // Sitting down
"intVal": 3 // Lying down
"intVal": 4 // Reclining

측정 위치 (int: 열거형) (선택적 필드)

측정이 이루어진 팔과 팔의 일부

허용되는 값

"intVal": 1 // Left wrist
"intVal": 2 // Right wrist
"intVal": 3 // Left upper arm
"intVal": 4 // Right upper arm

Android

이름 com.google.blood_pressure.summary

데이터 유형 객체 AGGREGATE_BLOOD_PRESSURE_SUMMARY

필드 (형식—단위)

FIELD_BLOOD_PRESSURE_SYSTOLIC_AVERAGE (float—mmHg)

일정 기간 동안의 사용자의 평균 수축기 혈압입니다.

FIELD_BLOOD_PRESSURE_SYSTOLIC_MAX (float—mmHg)

일정 기간 동안의 사용자의 최대 수축기 혈압입니다.

FIELD_BLOOD_PRESSURE_SYSTOLIC_MIN (float—mmHg)

일정 기간 동안 사용자의 최소 수축기 혈압입니다.

FIELD_BLOOD_PRESSURE_DIASTOLIC_AVERAGE (float—mmHg)

일정 기간 동안의 사용자의 평균 확장기 혈압입니다.

FIELD_BLOOD_PRESSURE_DIASTOLIC_MAX (float—mmHg)

일정 기간 동안의 사용자의 최대 확장기 혈압입니다.

FIELD_BLOOD_PRESSURE_DIASTOLIC_MIN (float—mmHg)

일정 기간 동안 사용자의 최소 확장기 혈압입니다.

FIELD_BODY_POSITION (int—열거형) (선택적 필드)

측정값이 측정된 사용자의 신체 위치입니다.

허용되는 값

BODY_POSITION_STANDING // Standing up
BODY_POSITION_SITTING // Sitting down
BODY_POSITION_LYING_DOWN // Lying down
BODY_POSITION_SEMI_RECUMBENT // Reclining

FIELD_BLOOD_PRESSURE_MEASUREMENT_LOCATION (int—열거형) (선택 입력란)

측정이 이루어진 팔과 팔의 일부

허용되는 값

BLOOD_PRESSURE_MEASUREMENT_LOCATION_LEFT_WRIST // Left wrist
BLOOD_PRESSURE_MEASUREMENT_LOCATION_RIGHT_WRIST // Right wrist
BLOOD_PRESSURE_MEASUREMENT_LOCATION_LEFT_UPPER_ARM // Left upper arm
BLOOD_PRESSURE_MEASUREMENT_LOCATION_RIGHT_UPPER_ARM // Right upper arm

체온 요약

각 데이터 포인트는 일정 기간 동안 사용자의 평균, 최저, 최고 체온을 나타냅니다.

측정 위치가 시간 간격의 모든 데이터 포인트에서 동일한 경우 신체에서 측정된 위치도 있습니다.

REST

이름 com.google.body.temperature.summary

OAuth 권한 범위

https://www.googleapis.com/auth/fitness.body_temperature.read

필드 (형식—단위)

평균 (float—섭씨)

일정 기간 동안의 사용자의 평균 체온입니다.

max (float: 섭씨)

일정 기간 동안 사용자의 최고 체온입니다.

min (float—섭씨)

일정 기간 동안 사용자의 최저 체온입니다.

측정 위치 (int: 열거형) (선택적 필드)

사용자의 신체에서 체온을 측정한 위치입니다.

허용되는 값

"intVal": 1 // Armpit
"intVal": 2 // Finger
"intVal": 3 // Forehead
"intVal": 4 // Mouth (oral)
"intVal": 5 // Rectum
"intVal": 6 // Temporal artery
"intVal": 7 // Toe
"intVal": 8 // Ear (tympanic)
"intVal": 9 // Wrist
"intVal": 10 // Vagina

Android

이름 com.google.body.temperature.summary

데이터 유형 객체 AGGREGATE_BODY_TEMPERATURE_SUMMARY

필드 (형식—단위)

FIELD_AVERAGE (float—섭씨)

일정 기간 동안의 사용자의 평균 체온입니다.

FIELD_MAX (float—섭씨)

일정 기간 동안 사용자의 최고 체온입니다.

FIELD_MIN (float—섭씨)

일정 기간 동안 사용자의 최저 체온입니다.

FIELD_BODY_TEMPERATURE_MEASUREMENT_LOCATION (int—열거형) (선택적 입력란)

사용자의 신체에서 체온을 측정한 위치입니다.

허용되는 값

BODY_TEMPERATURE_MEASUREMENT_LOCATION_AXILLARY // Armpit
BODY_TEMPERATURE_MEASUREMENT_LOCATION_FINGER // Finger
BODY_TEMPERATURE_MEASUREMENT_LOCATION_FOREHEAD // Forehead
BODY_TEMPERATURE_MEASUREMENT_LOCATION_ORAL // Mouth (oral)
BODY_TEMPERATURE_MEASUREMENT_LOCATION_RECTAL // Rectum
BODY_TEMPERATURE_MEASUREMENT_LOCATION_TEMPORAL_ARTERY // Temporal artery
BODY_TEMPERATURE_MEASUREMENT_LOCATION_TOE // Toe
BODY_TEMPERATURE_MEASUREMENT_LOCATION_TYMPANIC // Ear (tympanic
BODY_TEMPERATURE_MEASUREMENT_LOCATION_WRIST // Wrist
BODY_TEMPERATURE_MEASUREMENT_LOCATION_VAGINAL // Vagina

산소 포화도 요약

각 데이터 포인트는 시간 간격 사용자의 혈중 산소 포화도 및 보충 산소 유량의 평균, 최소, 최대를 나타냅니다.

이러한 각 필드의 값이 해당 기간 동안 측정된 모든 측정의 값이 같으면 반환된 데이터에 필드 값이 표시됩니다.

산소 요법 투여 모드
산소 포화 시스템
산소 포화도 측정 방법

측정값에서 값이 다르면 해당 필드는 제외됩니다.

REST

이름 com.google.oxygen_saturation.summary

OAuth 권한 범위

https://www.googleapis.com/auth/fitness.oxygen_saturation.read

필드 (형식—단위)

평균 산소 포화도 (float: 백분율)

일정 기간 동안 사용자의 평균 산소 포화도입니다.

최대 산소 포화도 (float: 백분율)

일정 기간 중 사용자의 최대 산소 포화도입니다.

min 산소 포화도 (float: 백분율)

일정 기간에 대한 사용자의 최소 산소 포화도입니다.

평균 보충 산소 유량 (float~L/min)

일정 기간 동안 사용자의 평균 보충 산소 유량입니다.

최대 보충 산소 유량 (float~L/min)

일정 기간 동안 사용자의 최대 보충 산소 유량입니다.

최소 보충 산소 유량 (float~L/min)

일정 기간 동안 사용자의 최소 보충 산소 유량입니다.

산소 요법 투여 모드 (int—열거형) (선택적 입력란)

산소 요법이 투여되는 방식

비강으로 투여하는 경우 결핍일 수 있으며 1합니다.

산소 포화도 시스템 (int—열거형) (선택적 입력란)

산소 포화도가 측정되는 위치입니다.

부재 또는 1일 수 있음(주변 모세 혈관에서 측정된 경우)

산소 포화도 측정 방법 (int: 열거형) (선택적 필드)

산소 포화도 측정 방법

맥박 산소 포화도로 측정한 경우 없거나 1일 수 있습니다.

Android

이름 com.google.oxygen_saturation.summary

데이터 유형 객체 AGGREGATE_OXYGEN_SATURATION_SUMMARY

필드 (형식—단위)

FIELD_OXYGEN_SATURATION_AVERAGE (float: 비율)

일정 기간 동안 사용자의 평균 산소 포화도입니다.

FIELD_OXYGEN_SATURATION_MAX (float: 비율)

일정 기간 중 사용자의 최대 산소 포화도입니다.

FIELD_OXYGEN_SATURATION_MIN (float: 비율)

일정 기간에 대한 사용자의 최소 산소 포화도입니다.

FIELD_SUPPLEMENTAL_OXYGEN_FLOW_RATE_AVERAGE (float~L/분)

일정 기간 동안 사용자의 평균 보충 산소 유량입니다.

FIELD_SUPPLEMENTAL_OXYGEN_FLOW_RATE_MAX (float~L/분)

일정 기간 동안 사용자의 최대 보충 산소 유량입니다.

FIELD_SUPPLEMENTAL_OXYGEN_FLOW_RATE_MIN (float~L/분)

일정 기간 동안 사용자의 최소 보충 산소 유량입니다.

FIELD_OXYGEN_THERAPY_ADMINISTRATION_MODE (int—열거형) (선택 입력란)

산소 요법이 투여되는 방식

비강으로 투여하는 경우 결핍일 수 있으며 1합니다.

FIELD_OXYGEN_SATURATION_SYSTEM (int—열거형) (선택적 필드)

산소 포화도가 측정되는 위치입니다.

부재 또는 1일 수 있음(주변 모세 혈관에서 측정된 경우)

FIELD_OXYGEN_SATURATION_MEASUREMENT_METHOD (int: 열거형) (선택적 필드)

산소 포화도 측정 방법

맥박 산소 포화도로 측정한 경우 없거나 1일 수 있습니다.