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 集成。

此页面由 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
字段（格式 - 单位）	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) 值
步行速度

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

数据	1 HP（低中等强度活动）	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 分心肺强化分数。还有一分钟高强度运动可获得 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` - 毫秒）获得的活动时间（以毫秒为单位）。有效范围：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
字段（格式 - 单位）	watts（`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 - 枚举）

运动的重复次数。

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 - 毫秒）

运动的持续时间，持续时间很重要。

活动数据类型 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

活动

REST

Android

基础代谢率 (BMR)

REST

Android

消耗卡路里数

REST

Android

单车踩踏频率

REST

Android

单车踩踏累计

REST

Android

心肺强化分数

REST

Android

活动时间

REST

Android

电源

REST

Android

步数统计频率

REST

Android

步数增量

REST

Android

健身

REST

Android

活动数据类型