健康数据类型

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) 血糖水平或浓度（以毫摩尔/升为单位），其中 1 毫摩尔/升为 18 毫克/分升。 与餐食的时间关系（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 meal type（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 - 毫摩尔/升） 血糖水平或浓度（以毫摩尔/升为单位），其中 1 毫摩尔/升为 18 毫克/分升。 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
字段（格式 - 单位）	收缩压 (float—mmHg) 收缩压测量值。 舒张压 (float—mmHg) 舒张压测量值。 正文位置（int - 枚举）（可选字段） 测量时用户的身体位置。 已接受的值 "intVal": 1 // Standing up "intVal": 2 // Sitting down "intVal": 3 // Lying down "intVal": 4 // Reclining 测量位置（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 摄氏度） 体温（以摄氏度为单位）。 测量位置（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
字段（格式 - 单位）	高度（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
字段（格式 - 单位）	月经出血（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
字段（格式 - 单位）	重量 (float-kgs) 体重，以公斤为单位。 有效范围：0—1000 千克

Android

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

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

注意 ：Google 已暂时停止接受向健康数据类型写入数据的新请求。我们更新了政策。自政策开始执行后，读取和写入数据的流程将会发生变化。

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

1. 确保您的应用符合 Google 的 API 用户数据政策以及 Google 健身开发者和用户数据政策。

2. 申请您的同意屏幕以通过 Google 验证。

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

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