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

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

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

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

활동 데이터 유형

이러한 데이터 유형은 다음과 같은 활동, 운동, 측정항목을 캡처하는 데 사용할 수 있습니다. 연습해 보겠습니다

활동

이 데이터 유형은 사용자가 하는 모든 활동을 캡처하는 데 사용할 수 있습니다. 달리기나 다양한 스포츠와 같은 일반적인 피트니스 활동뿐만 아니라 명상, 정원 가꾸기, 수면과 같은 활동도 여기에 포함될 수 있습니다.

사용자가 해당 기간 동안 두 개 이상의 활동을 한 경우 기본 활동 유형의 세션과 여러 활동 유형의 세그먼트를 만듭니다. 예를 들어 종합 격투기 수업에서 킥복싱과 복싱을 약간 한 경우 종합 격투기 세션을 만듭니다. 그런 다음 다양한 세그먼트로 분류할 수 있습니다.

각 데이터 포인트에는 시작 시간과 종료 시간이 필요합니다. 데이터 포인트는 연속되거나 서로 바로 이어질 필요는 없으며 그 사이에 간격이 있을 수 있습니다.

REST

이름	`com.google.activity.segment`
OAuth 권한 범위	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
필드(형식—단위)	활동 유형(`int`: enum) 사용자가 한 활동 유형입니다. 활동 유형 목록은 여기를 참고하세요.

Android

이름	`com.google.activity.segment`
데이터 유형 객체	`TYPE_ACTIVITY_SEGMENT`
Android 권한	`ACTIVITY_RECOGNITION`
필드(형식—단위)	FIELD_ACTIVITY (`int`: 열거형) 사용자가 한 활동 유형입니다. 활동 유형 목록은 여기를 참고하세요.

기초대사율 (BMR)

이 데이터 유형은 사용자의 BMR을 킬로칼로리 단위로 캡처합니다. 각 데이터 포인트는 사용자의 키와 체중을 기준으로 사용자가 하루 종일 휴식을 취할 때 소모하는 킬로칼로리 수를 나타냅니다. 종료 시간만 설정해야 합니다. 이는 측정값의 타임스탬프로 사용됩니다.

REST

이름	`com.google.calories.bmr`
OAuth 권한 범위	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
필드(형식—단위)	칼로리 (`float`~kcal/일) 키와 체중을 기준으로 사용자가 하루 종일 휴식을 취할 때 소모하는 킬로칼로리입니다.

Android

이름	`com.google.calories.bmr`
데이터 유형 객체	`TYPE_BASAL_METABOLIC_RATE`
필드 (형식 - 단위)	FIELD_CALORIES (일일 `float`~kcal) 나이, 체중, 키를 기준으로 사용자가 하루 종일 쉬면 소모되는 킬로칼로리입니다.

칼로리 소모량

이 데이터 유형은 사용자에게 표시됩니다. 각 데이터 포인트는 시간 간격 동안 소모된 총 킬로칼로리를 나타내므로 시작 시간과 종료 시간을 모두 설정해야 합니다.

REST

이름	`com.google.calories.expended`
OAuth 권한 범위	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
필드 (형식 - 단위)	calories (`float`~kcal) 소모한 킬로칼로리 수입니다.

Android

이름	`com.google.calories.expended`
데이터 유형 객체	`TYPE_CALORIES_EXPENDED`
Android 권한	`ACTIVITY_RECOGNITION`
필드(형식—단위)	FIELD_CALORIES (`float`~kcal) 소모한 킬로칼로리 수

사이클링 페달 회전수

사용자가 자전거를 타는 경우 이 데이터 유형을 사용하여 사용자의 페달을 밟을 수 있습니다. 속도를 분당 크랭크 회전수 (RPM)로 표시합니다. 각 데이터 포인트는 페달링 속도의 순간 측정값을 나타내므로 종료 시간만 설정해야 합니다. 이는 읽기의 타임스탬프로 사용됩니다.

REST

이름	`com.google.cycling.pedaling.cadence`
OAuth 권한 범위	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
필드 (형식 - 단위)	rpm (`float`~rpm) 분당 자전거 크랭크 회전수입니다.

Android

이름	`com.google.cycling.pedaling.cadence`
데이터 유형 객체	`TYPE_CYCLING_PEDALING_CADENCE`
필드(형식—단위)	FIELD_RPM (`float`~rpm) 분당 자전거 크랭크 회전 수입니다.

사이클링 페달 누적 횟수

사용자가 자전거를 타는 경우 이 데이터 유형을 사용하여 크랭크 혁신의 혁명이라 할 수 있습니다. 각 데이터 포인트는 회전할 수 있습니다.

REST

이름	`com.google.cycling.pedaling.cumulative`
OAuth 권한 범위	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
필드 (형식 - 단위)	회전 (`int`—회수) 일정 기간 동안 자전거 크랭크의 회전수입니다.

Android

이름	`com.google.cycling.pedaling.cumulative`
데이터 유형 객체	`TYPE_CYCLING_PEDALING_CUMULATIVE`
필드 (형식 - 단위)	FIELD_REVOLUTIONS (`int`—개수) 일정 기간 동안 자전거 크랭크의 회전수입니다.

심장 강화 점수

이 데이터 유형은 사용자가 모든 활동에서 획득한 심장 강화 점수를 나타냅니다. 각 데이터 포인트는 시간 간격에 대해 계산된 하트 포인트 수를 나타냅니다.

사용자는 일일 심장 강화 점수 목표를 설정하고 달성률을 모니터링할 수 있습니다. 심장 강화 점수 다음과 같이 계산할 수 있습니다.

심박수
MET (Metabolic Equivalent of Task) 값
걷기 속도

획득하는 심장 강화 점수는 활동의 강도에 따라 다릅니다. 사용 심장 강화 점수를 계산하고 작성하기 위한 가이드:

데이터	1HP (낮은 강도의 강도 활동)	2HP (고강도 활동)
심박수	최대 심박수의 50% 이상으로 1분 동안 활동	최대 심박수 70% 초과로 1분 활동
MET 값	3~6 MET 예를 들어 조정이나 암벽 등반,	6MET 이상 예: HIIT, 스키, 배구, 미식축구
보행 속도	분당 100~130걸음	분당 130걸음 초과

REST

이름	`com.google.heart_minutes`
OAuth 권한 범위	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
필드(형식—단위)	강도 (`float`: 심장 강화 점수) 사용자가 하는 운동 또는 활동의 강도에 따라 획득한 심장 강화 점수입니다.

Android

이름	`com.google.heart_minutes`
데이터 유형 객체	`TYPE_HEART_MINUTES`
필드 (형식 - 단위)	FIELD_INTENSITY (`float`: 하트 포인트) 사용자가 하는 운동 또는 활동의 강도입니다. 1분 가볍거나 중간 정도의 신체 활동 (예: 시속 4.8km보다 빠르게 걷기, 10mph 이상으로 자전거를 타는 경우)은 심장 강화 점수 1점을 얻습니다. 1분 더 보기 고강도 활동은 심장 강화 점수 2점을 얻습니다.

운동 시간

이 데이터 유형은 Google 피트니스가 운동 시간(분)을 캡처하여 수익을 얻을 수 있습니다. 각 데이터 포인트는 시간 간격의 파생된 이동 시간(분) 수를 나타냅니다. 시작 시간과 종료 시간 모두 설정해야 합니다.

사용자는 요가, 댄스, 정원 가꾸기, 기타 집안일과 같은 활동으로 이동 분을 획득할 수 있습니다. 사용자가 산책을 하면 Google 피트니스에서 무브 1개를 부여합니다. 60초 이내에 30걸음 이상 걸을 때마다 분을 계산합니다.

REST

이름	`com.google.active_minutes`
OAuth 권한 범위	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
필드 (형식 - 단위)	duration(`int`: 밀리초) 획득한 이동 시간(밀리초)입니다. 유효 범위: >=0

Android

이름	`com.google.active_minutes`
데이터 유형 객체	`TYPE_MOVE_MINUTES`
필드 (형식 - 단위)	FIELD_DURATION (`int`~밀리초) 획득한 운동 시간(분)의 지속 시간(밀리초)입니다. 유효 범위: 0~Long.MAX_VALUE

전원

이 데이터 유형은 사용자가 활동을 할 때 생성되는 전력을 캡처합니다. 와트 단위로 측정됩니다. 예를 들어 고정식 자전거에서 운동할 때 파워 미터를 사용하는 경우입니다. 각 데이터 포인트는 데이터의 즉각적인 측정을 나타냅니다. 발전시켰습니다.

각 데이터 포인트는 생성된 전력의 즉각적인 측정을 나타내므로 종료 시간을 설정해야 합니다. 이는 읽기의 타임스탬프로 사용됩니다.

REST

이름	`com.google.power.sample`
OAuth 권한 범위	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
필드(형식—단위)	와트 (`float` - 와트) 생성된 전력(와트)

Android

이름	`com.google.power.sample`
데이터 유형 객체	`TYPE_POWER_SAMPLE`
필드 (형식 - 단위)	FIELD_WATTS(`float`: 와트) 생성된 전력(와트)

걸음 수 주기

이 데이터 유형은 분당 걸음 수로 측정된 걷기 주기를 캡처합니다. 각 데이터 포인트는 각 단계의 걸음 수에 대한 즉각적인 측정을 나타냅니다 분.

REST

이름	`com.google.step_count.cadence`
OAuth 권한 범위	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
필드 (형식 - 단위)	rpm(`float`: 걸음/분) 분당 걸음 수로 측정된 보행 주기입니다.

Android

이름	`com.google.step_count.cadence`
데이터 유형 객체	`TYPE_STEP_COUNT_CADENCE`
필드 (형식 - 단위)	FIELD_RPM (`float`—걸음/분) 분당 걸음 수로 측정된 케이던스입니다.

걸음 수 델타

이 데이터 유형은 마지막 측정값 이후 걸은 걸음 수를 캡처합니다. 각 단계는 한 번만 보고되므로 데이터 포인트에 겹치는 시간이 있어서는 안 됩니다. 이 각 데이터 포인트의 시작 시간은 어떤 조치를 취했는지 알 수 있습니다.

시작 시간은 이전 데이터 포인트의 종료 시간보다 크거나 같아야 합니다. 특정 기간의 모든 값을 더하면 해당 기간의 총 걸음 수가 계산됩니다.

REST

이름 com.google.step_count.delta

OAuth 권한 범위

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

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

필드(형식—단위)

steps (int—개수)

특정 기간 동안 걸은 걸음 수입니다.

유효 범위: 초당 0~10단계

Android

이름 com.google.step_count.delta

데이터 유형 객체 TYPE_STEP_COUNT_DELTA

Android 권한 ACTIVITY_RECOGNITION

필드(형식—단위)

TYPE_STEP_COUNT_DELTA(int: 개수)

일정 기간 동안의 걸음 수입니다.

유효 범위: 초당 0~10단계

운동

각 데이터 포인트는 사용자가 수행한 연속적인 단일 운동 세트를 나타냅니다. 데이터 포인트에는 운동 유형( 저항 운동이나 웨이트 트레이닝), 운동의 반복 횟수와 운동, 운동 시간 및 저항성 등 여러 가지 요인이 있습니다.

REST

이름 com.google.activity.exercise

OAuth 권한 범위

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

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

필드 (형식 - 단위)

exercise (int: 열거형)

웨이트 리프팅 운동, 근력 운동, 심혈관 운동과 같은 다양한 운동을 나타내는 값입니다.

허용 값

back_extension
bridge.hip.single_leg
burpee
calf_press
calf_raise
calf_raise.seated
calf_raise.standing
chinup
clean
clean.hang
clean.hang_power
clean.jerk
clean.power
crunch
crunch.twisting
curl.bicep
deadlift
deadlift.rdl
deadlift.single_leg
deadlift.straight_leg
dip
dip.chest
dip.triceps
fly
good_morning
hip_extension
hip_raise
hip_thrust
jumping_jack
leg_curl
leg_extension
leg_press
leg_raise
lunge
lunge.rear
lunge.side
plank
plank.side
press.bench
press.bench.close_grip
press.bench.decline
press.bench.incline
press.jm
press.pike
press.shoulder
press.shoulder.arnold
press.shoulder.military
pulldown
pullover
pullup
pushup
pushup.close_grip
pushup.pike
raise.front
raise.lateral
raise.lateral.rear
row
row.high
row.upright
run.high_knee
russian_twist
shrug
situp
situp.twisting
squat
step_up
swing
thruster
triceps_extension
vups
wall_sit

repetitions (int - 열거형)

운동 반복 횟수입니다.

저항 유형 (int: 열거형)

운동 중 사용하는 저항의 유형입니다.

허용 값

"intVal": 0 // The resistance type is unknown, unspecified, or can't be represented by a value.
"intVal": 1 // The user is using a barbell for resistance.
"intVal": 2 // The user is using a cable for resistance. If using 2 cables are used (one for each arm), include the resistance weight for one arm.
"intVal": 3 // The user is using dumbells for resistance.
"intVal": 4 // The user is using a kettlebell for resistance
"intVal": 5 // The user is performing the exercise in a machine.
"intVal": 6 // The user is using their own body weight for resistance.

저항(float:kg)

운동의 저항(또는 중량)으로, 단위는 킬로그램입니다.

duration (int: 밀리초)

지속 시간이 중요한 운동 시간입니다.

Android

이름 com.google.activity.exercise

필드(형식—단위)

FIELD_EXERCISE (int: 열거형)

웨이트 리프팅 운동, 근력 운동, 심혈관 운동과 같은 다양한 운동을 나타내는 값입니다.

허용 값

ARNOLD_PRESS
BACK_EXTENSION
BENCH_PRESS
BICEP_CURL
BURPEE
CALF_PRESS
CALF_RAISE
CHEST_DIP
CHINUP
CLEAN
CLEAN_JERK
CLOSE_GRIP_BENCH_PRESS
CLOSE_GRIP_PUSHUP
CRUNCH
DEADLIFT
DECLINE_BENCH_PRESS
DIP
FLY
FRONT_RAISE
GOOD_MORNING
HANG_CLEAN
HANG_POWER_CLEAN
HIGH_KNEE_RUN
HIGH_ROW
HIP_EXTENSION
HIP_RAISE
HIP_THRUST
INCLINE_BENCH_PRESS
JM_PRESS
JUMPING_JACK
LATERAL_RAISE
LEG_CURL
LEG_EXTENSION
LEG_PRESS
LEG_RAISE
LUNGE
MILITARY_PRESS
PIKE_PRESS
PIKE_PUSHUP
PLANK
POWER_CLEAN
PULLDOWN
PULLOVER
PULLUP
PUSHUP
RDL_DEADLIFT
REAR_LATERAL_RAISE
REAR_LUNGE
ROW
RUSSIAN_TWIST
SEATED_CALF_RAISE
SHOULDER_PRESS
SHRUG
SIDE_LUNGE
SIDE_PLANK
SINGLE_LEG_DEADLIFT
SINGLE_LEG_HIP_BRIDGE
SITUP
SQUAT
STANDING_CALF_RAISE
STEP_UP
STRAIGHT_LEG_DEADLIFT
SWING
THRUSTER
TRICEPS_DIP
TRICEPS_EXTENSION
TWISTING_CRUNCH
TWISTING_SITUP
UPRIGHT_ROW
V_UPS
WALL_SIT

FIELD_REPETITIONS(int: 개수)

운동 반복 횟수입니다.

FIELD_RESISTANCE_TYPE (int: 열거형)

운동 중에 사용되는 저항 유형입니다.

허용 값

RESISTANCE_TYPE_UNKNOWN // The resistance type is unknown, unspecified, or can't be represented by a value.
RESISTANCE_TYPE_BARBELL // The user is using a barbell for resistance.
RESISTANCE_TYPE_CABLE // The user is using a cable for resistance. If using 2 cables are used (one for each arm), include the resistance weight for one arm.
RESISTANCE_TYPE_DUMBBELL // The user is using dumbells for resistance.
RESISTANCE_TYPE_KETTLEBELL // The user is using a kettlebell for resistance
RESISTANCE_TYPE_MACHINE // The user is performing the exercise in a machine.
RESISTANCE_TYPE_BODY // The user is using their own body weight for resistance.

FIELD_RESISTANCE(float: kg)

운동(또는 체중)의 저항력(킬로그램)입니다.

FIELD_DURATION (int~밀리초)

지속 시간이 중요한 운동 시간입니다.