Google 피트니스 REST API를 비롯한 Google 피트니스 API는 2026년에 지원 중단될 예정입니다. 2024년 5월 1일부터 개발자는 이러한 API를 사용하도록 가입할 수 없습니다.

이전할 API 또는 플랫폼에 관한 안내는 헬스 커넥트 이전 가이드를 참고하세요. 헬스 커넥트와 Google Fit 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`: 열거형) 사용자가 한 활동 유형입니다. 활동 유형 목록은 여기를 참고하세요.

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~6MET입니다. 예를 들어 조정이나 암벽 등반,	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~밀리초)

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

활동 데이터 유형 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

활동

REST

Android

기초대사율 (BMR)

REST

Android

칼로리 소모량

REST

Android

사이클링 페달 회전수

REST

Android

사이클링 페달 누적 횟수

REST

Android

심장 강화 점수

REST

Android

운동 시간

REST

Android

전원

REST

Android

걸음 수 주기

REST

Android

걸음 수 델타

REST

Android

운동

REST

Android

활동 데이터 유형