Google Fit API（包括 Google Fit REST API）在 2025 年 6 月 30 日之后将不再可用。自 2024 年 5 月 1 日起，开发者无法注册使用这些 API。

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

详细了解 Health Connect 以及如何与该 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
字段（格式 - 单位）	activity 类型（`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` - 千卡/天）用户全天休息时会消耗的千卡数，基于用户的年龄、体重和身高。

消耗卡路里数

此数据类型用于捕获用户消耗的总卡路里数（以千卡为单位），包括休息时消耗的卡路里数 (BMR)。每个数据点都表示一段时间内消耗的总千卡路里，因此应设置开始时间和结束时间。

REST

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

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
字段（格式 - 单位）	转/分钟 (`float` - 转/分钟) 每分钟自行车曲柄转数。

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

获得的心肺强化分数取决于活动强度。使用本指南介绍了如何计算和记录心肺强化分数：

数据	1 马力（低到中等强度的活动）	2 个 HP（高强度活动）
心率	最大心率超过 50% 时活动 1 分钟	以超过 70% 最大心率进行的活动 1 分钟
MET 值	MET：3-6例如，划船或攀岩	MET 高于 6例如，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` - 心形标记）用户进行的运动或活动的强度。进行轻度到中等强度的体力活动（例如步速超过 2.5 英里/小时或骑车速度超过 10 英里/小时）1 分钟可获得 1 分心肺强化分数。进行高强度活动 1 分钟可获得 2 分心肺强化分数。

活动时间

此数据类型会记录活动分钟数，Google 健身会计算从其所有活动中赚取的收入。每个数据点都代表一段时间间隔内的活动分钟数。必须设置开始时间和结束时间。

用户可以通过任何活动（例如瑜伽、跳舞、园艺和其他家务）赚取移动分钟数。如果他们去散步，Google 健身会奖励一次动作在 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` - 毫秒）获得的 Move 分钟数的时长（以毫秒为单位）。有效范围：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

字段（格式 - 单位）

步数（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 - 枚举）

锻炼的重复次数。

resiism type（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 - 千克）

运动（或体重）的阻力，以公斤为单位。

FIELD_DURATION（int - 毫秒）

时长至关重要的锻炼的时长。