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 翻译。

健康数据类型

Google 健身提供健康数据类型，可用于衡量与管理整体健康（而非健身）。

数据类型列表

如需详细了解健康数据类型及其字段，请参阅 Android 参考文档。单位为 enum 的字段均包含可供选择的值的列表请仅使用一个允许的值成功读取和写入数据。

血糖

此数据类型捕获血糖中的血糖浓度。每项数据点代表一个瞬时血糖读数。详细了解写入血糖数据。

REST

名称 com.google.blood_glucose

OAuth 权限范围

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

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

字段（格式 - 单位）

血糖水平 (float-mmol/L)

血糖水平或浓度以 mmol/L 为单位，其中 1 mmol/L 为 18 mg/dL。

与进餐的时间关系（int - 枚举）（选填字段）

获取读数与用户用餐时进行比较的时间。

已接受的值

"intVal": 1 // Reading wasn't taken before or after a meal
"intVal": 2 // Reading was taken during a fasting period
"intVal": 3 // Reading was taken before a meal
"intVal": 4 // Reading was taken after a meal

膳食类型（int - 枚举）（选填字段）

在获取读数时，用户吃的是什么餐点。

已接受的值

"intVal": 1 // Unknown
"intVal": 2 // Breakfast
"intVal": 3 // Lunch
"intVal": 4 // Dinner
"intVal": 5 // Snack

与睡眠的时间关系（int - 枚举）（选填字段）

获取读数与用户睡觉时间的对比情况。

已接受的值

"intVal": 1 // User was fully awake
"intVal": 2 // Before the user fell asleep
"intVal": 3 // After the user woke up
"intVal": 4 // While the user was still sleeping

样本来源（int - 枚举）（选填字段）

用于测量血糖的体液类型。

已接受的值

"intVal": 1 // Interstitial fluid
"intVal": 2 // Capillary blood
"intVal": 3 // Plasma
"intVal": 4 // Serum
"intVal": 5 // Tears
"intVal": 6 // Whole blood

Android

名称 com.google.blood_glucose

数据类型对象 TYPE_BLOOD_GLUCOSE

字段（格式 - 单位）

FIELD_BLOOD_GLUCOSE_LEVEL (float-mmol/L)

血糖水平或浓度以 mmol/L 为单位，其中 1 mmol/L 为 18 mg/dL。

FIELD_TEMPORAL_RELATION_TO_MEAL（int - 枚举）（可选字段）

获取读数与用户用餐时的时间比较。

已接受的值

FIELD_TEMPORAL_RELATION_TO_MEAL_GENERAL // Reading wasn't taken before or after a meal
FIELD_TEMPORAL_RELATION_TO_MEAL_FASTING // Reading was taken during a fasting period
FIELD_TEMPORAL_RELATION_TO_MEAL_BEFORE_MEAL // Reading was taken before a meal
FIELD_TEMPORAL_RELATION_TO_MEAL_AFTER_MEAL // Reading was taken after a meal

FIELD_MEAL_TYPE（int - 枚举）（选填字段）

在获取读数时，用户吃的是什么餐点。

已接受的值

MEAL_TYPE_UNKNOWN // Unknown
MEAL_TYPE_BREAKFAST // Breakfast
MEAL_TYPE_LUNCH // Lunch
MEAL_TYPE_DINNER // Dinner
MEAL_TYPE_SNACK // Snack

FIELD_TEMPORAL_RELATION_TO_SLEEP（int - 枚举）（可选字段）

获取读数与用户睡觉时间的对比情况。

已接受的值

TEMPORAL_RELATION_TO_SLEEP_FULLY_AWAKE // User was fully awake.
TEMPORAL_RELATION_TO_SLEEP_BEFORE_SLEEP // Before the user fell asleep.
TEMPORAL_RELATION_TO_SLEEP_ON_WAKING // After the user woke up.
TEMPORAL_RELATION_TO_SLEEP_DURING_SLEEP // While the user was still sleeping.

FIELD_BLOOD_GLUCOSE_SPECIMEN_SOURCE（int - 枚举）（选填字段）

用于测量血糖的体液类型。

已接受的值

BLOOD_GLUCOSE_SPECIMEN_SOURCE_INTERSTITIAL_FLUID // Interstitial fluid
BLOOD_GLUCOSE_SPECIMEN_SOURCE_CAPILLARY_BLOOD // Capillary blood
BLOOD_GLUCOSE_SPECIMEN_SOURCE_PLASMA // Plasma
BLOOD_GLUCOSE_SPECIMEN_SOURCE_SERUM // Serum
BLOOD_GLUCOSE_SPECIMEN_SOURCE_TEARS // Tears
BLOOD_GLUCOSE_SPECIMEN_SOURCE_WHOLE_BLOOD // Whole blood

血压

此数据类型会捕获用户的血压。每个数据点都代表一次瞬时血压读数。详细了解如何撰写血腥内容压力数据。

REST

名称 com.google.blood_pressure

OAuth 权限范围

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

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

字段（格式 - 单位）

systolic (float-mmHg)

收缩压测量。

舒张压 (float-mmHg)

舒张压测量。

body position（int - 枚举）（选填字段）

进行测量时用户的身体位置。

已接受的值

"intVal": 1 // Standing up
"intVal": 2 // Sitting down
"intVal": 3 // Lying down
"intVal": 4 // Reclining

measurement location（int - 枚举）（选填字段）

进行测量的手臂和手臂的哪部分。

已接受的值

"intVal": 1 // Left wrist
"intVal": 2 // Right wrist
"intVal": 3 // Left upper arm
"intVal": 4 // Right upper arm

Android

名称 com.google.blood_pressure

数据类型对象 TYPE_BLOOD_PRESSURE

字段（格式 - 单位）

FIELD_BLOOD_PRESSURE_SYSTOLIC（float - mmHg）

收缩压测量。

FIELD_BLOOD_PRESSURE_DIASTOLIC（float - mmHg）

舒张压测量。

FIELD_BODY_POSITION（int - 枚举）（选填字段）

进行测量时用户的身体位置。

已接受的值

BODY_POSITION_STANDING // Standing up
BODY_POSITION_SITTING // Sitting down
BODY_POSITION_LYING_DOWN // Lying down
BODY_POSITION_SEMI_RECUMBENT // Reclining

FIELD_BLOOD_PRESSURE_MEASUREMENT_LOCATION（int - 枚举）（可选字段）

进行测量的手臂和手臂的哪部分。

已接受的值

BLOOD_PRESSURE_MEASUREMENT_LOCATION_LEFT_WRIST // Left wrist
BLOOD_PRESSURE_MEASUREMENT_LOCATION_RIGHT_WRIST // Right wrist
BLOOD_PRESSURE_MEASUREMENT_LOCATION_LEFT_UPPER_ARM // Left upper arm
BLOOD_PRESSURE_MEASUREMENT_LOCATION_RIGHT_UPPER_ARM // Right upper arm

身体脂肪百分比

此数据类型会捕获用户的体脂百分比。每个数据点表示一个人的总体脂以占总体重的百分比。

REST

名称	`com.google.body.fat.percentage`
OAuth 权限范围	https://www.googleapis.com/auth/fitness.body.read https://www.googleapis.com/auth/fitness.body.write
字段（格式 - 单位）	percentage（`float` - 百分比）体脂在体重总数中所占的百分比。有效范围：0—100%

Android

名称	`com.google.body.fat.percentage`
数据类型对象	`TYPE_BODY_FAT_PERCENTAGE`
字段（格式 - 单位）	FIELD_PERCENTAGE（`float` - 百分比）体脂在体重总数中所占的百分比。有效范围：0—100%

体温

此数据类型会捕获用户的体温。每个数据点表示单次瞬时体温测量值。

REST

名称 com.google.body.temperature

OAuth 权限范围

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

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

字段（格式 - 单位）

体温（float—摄氏度）

体温（以摄氏度为单位）。

measurement location（int - 枚举）（选填字段）

测量体温时所依据的用户身体部位。

已接受的值

"intVal": 1 // Armpit
"intVal": 2 // Finger
"intVal": 3 // Forehead
"intVal": 4 // Mouth (oral)
"intVal": 5 // Rectum
"intVal": 6 // Temporal artery
"intVal": 7 // Toe
"intVal": 8 // Ear (tympanic)
"intVal": 9 // Wrist
"intVal": 10 // Vagina

Android

名称 com.google.body.temperature

数据类型对象 TYPE_BODY_TEMPERATURE

字段（格式 - 单位）

FIELD_BODY_TEMPERATURE（float - 摄氏度）

体温（以摄氏度为单位）。

FIELD_BODY_TEMPERATURE_MEASUREMENT_LOCATION（int - 枚举）（可选字段）

测量体温时所依据的用户身体部位。

已接受的值

BODY_TEMPERATURE_MEASUREMENT_LOCATION_AXILLARY // Armpit
BODY_TEMPERATURE_MEASUREMENT_LOCATION_FINGER // Finger
BODY_TEMPERATURE_MEASUREMENT_LOCATION_FOREHEAD // Forehead
BODY_TEMPERATURE_MEASUREMENT_LOCATION_ORAL // Mouth (oral)
BODY_TEMPERATURE_MEASUREMENT_LOCATION_RECTAL // Rectum
BODY_TEMPERATURE_MEASUREMENT_LOCATION_TEMPORAL_ARTERY // Temporal artery
BODY_TEMPERATURE_MEASUREMENT_LOCATION_TOE // Toe
BODY_TEMPERATURE_MEASUREMENT_LOCATION_TYMPANIC // Ear (tympanic
BODY_TEMPERATURE_MEASUREMENT_LOCATION_WRIST // Wrist
BODY_TEMPERATURE_MEASUREMENT_LOCATION_VAGINAL // Vagina

宫颈粘液

此数据类型可捕获宫颈粘液的描述。每个数据点代表对用户的宫颈粘液自行评估的说明。所有字段是可选的，可用于描述宫颈粘液的外观和感觉，和金额

REST

名称 com.google.cervical_mucus

OAuth 权限范围

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

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

字段（格式 - 单位）

宫颈粘液纹理（int - 枚举）（可选字段）

用户的宫颈粘液的一致性或纹理。

已接受的值

"intVal": 1 // Dry, little or no mucus
"intVal": 2 // Sticky
"intVal": 3 // Creamy
"intVal": 4 // Watery
"intVal": 5 // Clear and stretchy like egg white

宫颈粘液量（int - 枚举）（选填字段）

用户观察到的宫颈粘液量。

已接受的值

"intVal": 1 // Light
"intVal": 2 // Medium
"intVal": 3 // Heavy

Android

名称 com.google.cervical_mucus

数据类型对象 TYPE_CERVICAL_MUCUS

字段（格式 - 单位）

FIELD_CERVICAL_MUCUS_TEXTURE（int - 枚举）（可选字段）

用户的宫颈粘液的一致性或纹理。

已接受的值

CERVICAL_MUCUS_TEXTURE_DRY // Dry, little or no mucus
CERVICAL_MUCUS_TEXTURE_STICKY // Sticky
CERVICAL_MUCUS_TEXTURE_CREAMY // Creamy
CERVICAL_MUCUS_TEXTURE_WATERY // Watery
CERVICAL_MUCUS_TEXTURE_EGG_WHITE // Clear and stretchy

FIELD_CERVICAL_MUCUS_AMOUNT（int - 枚举）（选填字段）

用户观察到的宫颈粘液量。

已接受的值

CERVICAL_MUCUS_AMOUNT_LIGHT
CERVICAL_MUCUS_AMOUNT_MEDIUM
CERVICAL_MUCUS_AMOUNT_HEAVY

宫颈位置

在此数据类型中，每个数据点代表一份用户的宫颈报告。全部字段是可选字段，可用于添加位置说明、宫颈扩张和硬度。

REST

名称 com.google.cervical_position

OAuth 权限范围

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

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

字段（格式 - 单位）

宫颈位置（int - 枚举）（选填字段）

用户宫颈的位置。

已接受的值

"intVal": 1 // Cervix is low
"intVal": 2 // Cervix is in a medium position
"intVal": 3 // Cervix is high

宫颈扩张（int - 枚举）（选填字段）

用户宫颈的开放程度或扩张程度。

已接受的值

"intVal": 1 // Closed cervix
"intVal": 2 // Partially open cervix
"intVal": 3 // Fully dilated, open cervix

宫颈硬度（int - 枚举）（选填字段）

用户的宫颈有多硬。

已接受的值

"intVal": 1 // Cervix is soft
"intVal": 2 // Cervix is a little firm
"intVal": 3 // Cervix is firm

Android

名称 com.google.cervical_position

数据类型对象 TYPE_CERVICAL_POSITION

字段（格式 - 单位）

FIELD_CERVICAL_POSITION（int - 枚举）（可选字段）

用户宫颈的位置。

已接受的值

CERVICAL_POSITION_LOW
CERVICAL_POSITION_MEDIUM
CERVICAL_POSITION_HIGH

FIELD_CERVICAL_DILATION（int - 枚举）（选填字段）

用户宫颈的开放程度或扩张程度。

已接受的值

CERVICAL_DILATION_CLOSED // Closed cervix
CERVICAL_DILATION_MEDIUM // Partially open cervix
CERVICAL_DILATION_OPEN // Fully dilated, open cervix

FIELD_CERVICAL_FIRMNESS（int - 枚举）（选填字段）

用户的宫颈有多硬。

已接受的值

CERVICAL_FIRMNESS_SOFT
CERVICAL_FIRMNESS_MEDIUM
CERVICAL_FIRMNESS_FIRM

心率

此数据类型会捕获用户的心率（以每分钟心跳次数为单位）。因为每个数据点表示的是心率的瞬时测量值，仅表示结束时间。这将用作读取操作的时间戳。

REST

名称	`com.google.heart_rate.bpm`
OAuth 权限范围	https://www.googleapis.com/auth/fitness.heart_rate.read https://www.googleapis.com/auth/fitness.heart_rate.write
字段（格式 - 单位）	bpm (`float`-bpm) 心率（每分钟心跳次数）。有效范围：0—1000

Android

名称	`com.google.heart_rate.bpm`
数据类型对象	`TYPE_HEART_RATE_BPM`
Android 权限	`BODY_SENSORS`即可录制
字段（格式 - 单位）	bpm (`float`-bpm) 心率（每分钟心跳次数）。有效范围：0—1000 bpm

高度

此数据类型会捕获用户的身高（以米为单位）。因为每个数据点表示读取时用户身高，仅表示结束时间。这将用作读取操作的时间戳。

REST

名称	`com.google.height`
OAuth 权限范围	https://www.googleapis.com/auth/fitness.body.read https://www.googleapis.com/auth/fitness.body.write
字段（格式 - 单位）	height（`float` - 米）高度（以米为单位）。有效范围：0-3 米

Android

名称	`com.google.height`
数据类型对象	`TYPE_HEIGHT`
字段（格式 - 单位）	FIELD_HEIGHT（`float` - 米）高度（以米为单位）。有效范围：0-3 米

经期

此数据类型可记录用户的月经出血量（点滴出血、轻度、中度或重度）。每个数据点都代表用户的月经出血量。

REST

名称 com.google.menstruation

OAuth 权限范围

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

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

字段（格式 - 单位）

menstrual flow（int - 枚举）（选填字段）

用户的经期有多长。

已接受的值

"intVal": 1 // Spotting
"intVal": 2 // Light
"intVal": 3 // Medium
"intVal": 4 // Heavy

Android

名称 com.google.menstruation

数据类型对象 TYPE_MENSTRUATION

字段（格式 - 单位）

FIELD_MENSTRUAL_FLOW（int - 枚举）（可选字段）

用户的经期有多长。

已接受的值

MENSTRUAL_FLOW_SPOTTING // Spotting
MENSTRUAL_FLOW_LIGHT // Light
MENSTRUAL_FLOW_MEDIUM // Medium
MENSTRUAL_FLOW_HEAVY // Heavy

排卵测试

在此数据类型中，每个数据点代表排卵的二元结果测试（阳性或阴性）。

REST

名称 com.google.ovulation_test

OAuth 权限范围

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

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

字段（格式 - 单位）

排卵测试（int - 枚举）（选填字段）

用户的排卵测试结果，显示他们是否在排卵。

已接受的值

"intVal": 1 // Negative
"intVal": 2 // Positive

Android

名称 com.google.ovulation_test

数据类型对象 TYPE_OVULATION_TEST

字段（格式 - 单位）

FIELD_OVULATION_TEST_RESULT（int - 枚举）（可选字段）

用户的排卵测试结果，显示他们是否在排卵。

已接受的值

OVULATION_TEST_RESULT_NEGATIVE
OVULATION_TEST_RESULT_POSITIVE

血氧饱和度

此数据类型会捕获血液中循环的氧气量以饱和氧血红蛋白的百分比表示每个数据点都代表测量时的单个血氧饱和度读数。

如果你遇到以下情况，还可以通过可选字段添加有关任何补充氧气的详细信息资源。

REST

名称 com.google.oxygen_saturation

OAuth 权限范围

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

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

字段（格式 - 单位）

血氧饱和度（float—百分比）

血氧饱和度读数，以百分比表示。

有效范围：0—100%

补充供氧流速 (float—L/min)

向用户提供额外氧气的速率（以升/分钟为单位）。如果没有提供补充供氧，且用户正只能呼吸到空气。

氧疗法给药模式（int - 枚举）（选填字段）

氧治疗的执行方式。

如果通过鼻导管给药，该病可能缺失或 1。

血氧饱和度系统（int - 枚举）（选填字段）

测量血氧饱和度的位置。

如果在外周毛细血管中测量，则可能缺失或 1。

血氧饱和度测量方法（int - 枚举）（可选字段）

如何测量血氧饱和度。

如果通过脉搏血氧测量测量，则可能缺失或 1。

Android

名称 com.google.oxygen_saturation

数据类型对象 TYPE_OXYGEN_SATURATION

字段（格式 - 单位）

FIELD_OXYGEN_SATURATION（float - 百分比）

血氧饱和度读数，以百分比表示。

FIELD_SUPPLEMENTAL_OXYGEN_FLOW_RATE（float - L/分钟）

向用户提供额外氧气的速率（以升/分钟为单位）。零表示不提供补充供氧，且用户只能呼吸到空气。

FIELD_OXYGEN_THERAPY_ADMINISTRATION_MODE（int - 枚举）（选填字段）

氧治疗的执行方式。

如果通过鼻导管给药，该病可能缺失或 1。

FIELD_OXYGEN_SATURATION_SYSTEM（int - 枚举）（选填字段）

测量血氧饱和度的位置。

如果在外周毛细血管中测量，则可能缺失或 1。

FIELD_OXYGEN_SATURATION_MEASUREMENT_METHOD（int - 枚举）（选填字段）

如何测量血氧饱和度。

如果通过脉搏血氧测量测量，则可能缺失或 1。

睡眠

此数据类型会捕获用户的睡眠时长和类型。每个数据点表示某个睡眠阶段的时间间隔。

数据点的开始时间表示睡眠阶段的开始时间，始终需要包含在其中。时间戳表示睡眠的结束阶段。时间间隔不必是连续的，但不得重叠。

REST

名称 com.google.sleep.segment

OAuth 权限范围

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

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

字段（格式 - 单位）

睡眠细分类型（int - 枚举）

表示不同睡眠阶段和类型的值。

已接受的值

"intVal": 0 // Unspecified or unknown if user is sleeping.
"intVal": 1 // Awake; user is awake.
"intVal": 2 // Sleeping; generic or non-granular sleep description.
"intVal": 3 // Out of bed; user gets out of bed in the middle of a sleep session.
"intVal": 4 // Light sleep; user is in a light sleep cycle.
"intVal": 5 // Deep sleep; user is in a deep sleep cycle.
"intVal": 6 // REM sleep; user is in a REM sleep cyle.

Android

名称 com.google.sleep.segment

数据类型对象 TYPE_SLEEP_SEGMENT

字段（格式 - 单位）

FIELD_SLEEP_SEGMENT_TYPE（int - 枚举）

表示不同睡眠阶段和类型的值。

已接受的值

SLEEP_SEGMENT_TYPE_UNSPECIFIED // Unspecified or unknown if user is sleeping.
AWAKE // Awake; user is awake.
SLEEP // Sleeping; generic or non-granular sleep description.
OUT_OF_BED // Out of bed; user gets out of bed in the middle of a sleep session.
SLEEP_LIGHT // Light sleep; user is in a light sleep cycle.
SLEEP_DEEP // Deep sleep; user is in a deep sleep cycle.
SLEEP_REM // REM sleep; user is in a REM sleep cyle.

阴道点状出血

此数据类型会捕获用户在看到内容（其间隙出现血液）时）。每个数据点代表一次发现实例，因此每个数据点应具有时间戳，并且出现次数字段应设置为一个。

REST

名称 com.google.vaginal_spotting

OAuth 权限范围

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

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

字段（格式 - 单位）

occurrences（int - 个计数）

每一次发现。将此字段设置为 1。

Android

名称 com.google.vaginal_spotting

数据类型对象 TYPE_VAGINAL_SPOTTING

字段（格式 - 单位）

FIELD_OCCURRENCES（int - 计数）

每一次发现。将此字段设置为 1。

重量

此数据类型捕获用户的体重（以千克为单位）。因为每个数据点表示读取时用户的体重，仅表示结束时间。这将用作读取操作的时间戳。

REST

名称	`com.google.weight`
OAuth 权限范围	https://www.googleapis.com/auth/fitness.body.read https://www.googleapis.com/auth/fitness.body.write
字段（格式 - 单位）	weight (`float`-kgs) 体重，以公斤为单位。有效范围：0—1000 公斤

Android

名称	`com.google.weight`
数据类型对象	`TYPE_WEIGHT`
字段（格式 - 单位）	FIELD_WEIGHT（`float` - 千克）体重，以公斤为单位。有效范围：0—1000 公斤

获取读取和写入健康数据的权限

如需读取健康数据，请按以下步骤操作：

确保您的应用符合 Google 的 API 用户数据政策以及 Google 健身开发者和用户数据政策。
您可申请由 Google 验证您的同意屏幕。

注意：如果您的应用在请求访问敏感的 OAuth 范围，Google 将评估其风险并应用配额。您的用户还可能会看到警告屏幕。您仍然可以测试您的应用，但配额会限制您可以获得的新用户数。

如果您的应用通过验证，就可以读取用户已同意读取的健康数据。