Google 健身 API（包括 Google 健身 REST API）将于 2026 年废弃。自 2024 年 5 月 1 日起，开发者将无法注册使用这些 API。

如需了解应迁移到哪个 API 或平台，请参阅 Health Connect 迁移指南。如需将 Health Connect 与 Google Fit API 和 Fitbit Web API 进行比较，请参阅 Health Connect 比较指南。

详细了解 Health Connect 以及如何与该 API 集成。

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

活动数据类型

这些数据类型可用于捕获活动、锻炼和与锻炼相关的指标。

活动

此数据类型可用于捕获用户执行的任何活动。这可以是跑步或各种运动等常见健身活动，也可以是冥想、园艺和睡眠等活动。

如果用户在该时间段内进行了多种活动，请为主要活动类型创建一个会话，并为不同的活动类型创建多个细分。例如，如果用户在综合格斗课程中练习了少量的踢拳和拳击，请为综合格斗创建会话。然后，您可以将不同的活动类型细分为不同的细分。

每个数据点都需要一个开始时间和结束时间。数据点不必紧挨着或直接相连，中间可以有间隔。

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` 千卡）用户如果整天处于静息状态，根据其身高和体重会消耗的千卡数。

Android

名称	`com.google.calories.bmr`
数据类型对象	`TYPE_BASAL_METABOLIC_RATE`
字段（格式 - 单位）	FIELD_CALORIES（`float` - 每天千卡数）用户在整天静息状态下消耗的千卡数，根据其年龄、体重和身高计算得出。

消耗卡路里数

此数据类型可捕获用户消耗的总卡路里数（以千卡为单位），包括休息时消耗的卡路里数（基础代谢率）。每个数据点表示某个时间间隔内消耗的总千卡数，因此应同时设置开始时间和结束时间。

REST

名称	`com.google.calories.expended`
OAuth 权限范围	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
字段（格式 - 单位）	卡路里（`float` 千卡）消耗的千卡数。

Android

名称	`com.google.calories.expended`
数据类型对象	`TYPE_CALORIES_EXPENDED`
Android 权限	`ACTIVITY_RECOGNITION`
字段（格式 - 单位）	FIELD_CALORIES（`float` - 千卡）消耗的千卡数。

单车踩踏频率

如果用户骑自行车，可以使用此数据类型来捕获其踩踏频率，以每分钟曲柄转数 (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` - 转/分钟）每分钟的自行车曲柄转数。

骑车踩踏累计次数

如果用户去骑自行车，可以使用此数据类型来捕获一段时间内的曲柄旋转次数。每个数据点表示自开始时间以来旋转的圈数。

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) 值
步行速度

获得的心肺强化分数取决于活动的强度。请参阅本指南，了解如何计算和获得心肺强化分数：

数据	1 HP（低中强度活动）	2 个 HP（高强度活动）
心率	以高于最大心率 50% 的心率进行活动 1 分钟	以高于 70% 最大心率的强度进行活动 1 分钟
MET 值	3-6 MET。例如，划船或攀岩，	>6 MET。例如，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 分钟的低强度到中等强度的身体活动（例如以超过 2.5 英里的时速快走，或以超过 10 英里的时速骑自行车）可获得 1 分心肺强化分数。进行 1 分钟更高强度的活动可获得 2 分心肺强化分数。

活动时间

此数据类型会记录 Google 健身根据用户的所有活动计算出的活动时间。每个数据点都表示相应时间间隔内计算出的运动分钟数。必须同时设置开始时间和结束时间。

用户可以通过瑜伽、跳舞、园艺和其他家务活动来赚取活动时间。如果用户去散步，Google Fit 会在用户 60 秒内至少走 30 步时奖励 1 个运动分钟。

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
字段（格式 - 单位）	每分钟转数（`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

字段（格式 - 单位）

步数（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 千克）

锻炼的阻力（或重量），单位为千克。

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

活动数据类型