健康数据类型

Google 健身提供与管理健康(而非健身相关)相关的健康数据类型。

数据类型列表

您可以参阅 Android 参考文档,详细了解健康数据类型及其字段。包含 enum 单位的字段具有一系列接受的值可供选择。只能使用其中一个允许的值来成功读取和写入数据。

血糖

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

REST

Namecom.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 - 枚举)(可选字段)
获取读数的时间与用户吃饭的时间进行比较。
膳食类型int - 枚举)(可选字段)
读取读数时用户吃什么类型的膳食。
时间与睡眠的关系int - 枚举)(可选字段)
获取读数的时间与用户睡觉的时间。
样本来源int - 枚举)(可选字段)
用于测量血糖的体液类型。

Android

Namecom.google.blood_glucose
数据类型对象TYPE_BLOOD_GLUCOSE
字段(格式 - 单位)
FIELD_BLOOD_GLUCOSE_LEVEL (float—mmol/L)
血糖水平或以毫摩尔/升为单位,其中 1 毫摩尔/升为 18 毫克/分升。
FIELD_TEMPORAL_RELATION_TO_MEALint - 枚举)(可选字段)
获取读数的时间与用户吃饭的时间进行比较。
FIELD_MEAL_TYPEint - 枚举)(可选字段)
读取读数时用户吃什么类型的膳食。
FIELD_TEMPORAL_RELATION_TO_SLEEPint - 枚举)(可选字段)
获取读数的时间与用户睡觉的时间。
FIELD_BLOOD_GLUCOSE_SPECIMEN_SOURCEint - 枚举)(可选字段)
用于测量血糖的体液类型。

血压

此数据类型捕获用户的血压。每个数据点代表一个瞬时血压读数。详细了解如何写入血压数据

REST

Namecom.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)
舒张压记录。
body positionint - 枚举值,可选字段)
测量时用户的身体姿势。
衡量位置int - 枚举)(可选字段)
进行测量的实验组和实验组。

Android

Namecom.google.blood_pressure
数据类型对象TYPE_BLOOD_PRESSURE
字段(格式 - 单位)
FIELD_BLOOD_PRESSURE_SYSTOLICfloat - mmHg)
收缩压测量结果。
FIELD_BLOOD_PRESSURE_DIASTOLIC (float—mmHg)
舒张压记录。
FIELD_Body_POSITIONint - 枚举)(可选字段)
测量时用户的身体姿势。
FIELD_BLOOD_PRESSURE_MEASUREMENT_LOCATIONint - 枚举)(可选字段)
进行测量的实验组和实验组。

身体脂肪百分比

此类型捕获用户的体脂百分比。每个数据点代表一个人体脂总量占身体总质量的百分比。

REST

Namecom.google.body.fat.percentage
OAuth 权限范围
https://www.googleapis.com/auth/fitness.body.read
https://www.googleapis.com/auth/fitness.body.write
字段(格式 - 单位) percentage (float—percent)
身体脂肪占总脂肪的百分比。
有效范围:0–100%

Android

Namecom.google.body.fat.percentage
数据类型对象TYPE_BODY_FAT_PERCENTAGE
字段(格式 - 单位) FIELD_PERCENTAGE(百分比为 float
身体脂肪占总脂肪的百分比。
有效范围:0–100%

体温

此数据类型会捕获用户的体温。每个数据点代表一个瞬时体温测量结果。

REST

Namecom.google.body.temperature
OAuth 权限范围
https://www.googleapis.com/auth/fitness.body_temperature.read
https://www.googleapis.com/auth/fitness.body_temperature.write
字段(格式 - 单位)
体温float - 摄氏度)
体温(以摄氏度为单位)。
衡量位置int - 枚举)(可选字段)
测量体温是在用户的身体部位。

Android

Namecom.google.body.temperature
数据类型对象类型_正文_温度
字段(格式 - 单位)
FIELD_Body_TEMPERATUREfloat - 摄氏度)
体温(以摄氏度为单位)。
FIELD_Body_TEMPERATURE_MEASUREMENT_LOCATIONint - 枚举)(可选字段)
测量体温是在用户的身体部位。

宫颈粘液

此数据类型可捕获宫颈粘液的说明。每个数据点代表对用户的宫颈粘液的自行描述。所有字段均为选填字段,可用于描述宫颈粘液的外观和数量。

REST

Namecom.google.cervical_mucus
OAuth 权限范围
https://www.googleapis.com/auth/fitness.reproductive_health.read
https://www.googleapis.com/auth/fitness.reproductive_health.write
字段(格式 - 单位)
宫颈粘液质地int - 枚举)(选填字段)
用户的宫颈粘液的一致性或质地。
宫颈粘液量int - 枚举)(选填字段)
用户观察到的宫颈粘液量。

Android

Namecom.google.cervical_mucus
数据类型对象TYPE_CERVICAL_MUCUS
字段(格式 - 单位)
FIELD_CERVICAL_MUCUS_TEXTUREint - 枚举)(可选字段)
用户的宫颈粘液的一致性或质地。
FIELD_CERVICAL_MUCUS_AMOUNTint - 枚举)(可选字段)
用户观察到的宫颈粘液量。

宫颈位置

在此数据类型中,每个数据点代表一个宫颈的报告。所有字段均为选填,可用于添加宫颈的位置、扩张和硬度说明。

REST

Namecom.google.cervical_position
OAuth 权限范围
https://www.googleapis.com/auth/fitness.reproductive_health.read
https://www.googleapis.com/auth/fitness.reproductive_health.write
字段(格式 - 单位)
宫颈位置int - 枚举)(选填字段)
宫颈位置。
宫颈扩张int - 枚举)(可选字段)
宫颈的开放或扩张情况。
宫颈强度int - 枚举)(选填字段)
用户的宫颈有多坚固。

Android

Namecom.google.cervical_position
数据类型对象TYPE_CERVICAL_POSITION
字段(格式 - 单位)
FIELD_CERVICAL_POSITIONint - 枚举)(可选字段)
宫颈位置。
FIELD_CERVICAL_DILATIONint - 枚举)(可选字段)
宫颈的开放或扩张情况。
FIELD_CERVICAL_FIRMNESSint - 枚举)(可选字段)
用户宫颈的坚定程度。

心率

此数据类型捕获用户的每分钟心跳次数。由于每个数据点都代表心率的瞬时测量结果,因此只应设置结束时间。此值将用作读取操作的时间戳。

REST

Namecom.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

Namecom.google.heart_rate.bpm
数据类型对象TYPE_HEART_RATE_BPM
Android 权限BODY_SENSORS待录制
字段(格式 - 单位) bpm (float—bpm)
每分钟心跳次数。
有效范围:0-1000 bpm

身高

此数据类型可捕获用户的身高(以米为单位)。由于每个数据点都表示用户在读取时的高度,因此应仅设置结束时间。此值将用作读取操作的时间戳。

REST

Namecom.google.height
OAuth 权限范围
https://www.googleapis.com/auth/fitness.body.read
https://www.googleapis.com/auth/fitness.body.write
字段(格式 - 单位) heightfloat - 米)
高度(米)。
有效范围:0-3 米

Android

Namecom.google.height
数据类型对象TYPE_HEIGHT
字段(格式 - 单位) FIELD_HEIGHTfloat - 米)
高度(米)。
有效范围:0-3 米

经期

此数据类型用于捕获有关用户月经周期经量(点点、轻度、中度或重度)的说明。每个数据点都表示用户的月经出血量。

REST

Namecom.google.menstruation
OAuth 权限范围
https://www.googleapis.com/auth/fitness.reproductive_health.read
https://www.googleapis.com/auth/fitness.reproductive_health.write
字段(格式 - 单位)
经期int - 枚举)(选填字段)
用户生理周期的粗细。

Android

Namecom.google.menstruation
数据类型对象TYPE_MENSTRUATION
字段(格式 - 单位)
FIELD_MENSTRUAL_FLOWint - 枚举)(可选字段)
用户生理周期的粗细。

排卵检测

在此数据类型中,每个数据点表示排卵检测的二次结果(正或负)。

REST

Namecom.google.ovulation_test
OAuth 权限范围
https://www.googleapis.com/auth/fitness.reproductive_health.read
https://www.googleapis.com/auth/fitness.reproductive_health.write
字段(格式 - 单位)
排卵测试int - 枚举)(可选字段)
用户的排卵测试的结果,显示用户是否正在排卵。

Android

Namecom.google.ovulation_test
数据类型对象类型_测试_测试
字段(格式 - 单位)
FIELD_OVULATION_TEST_RESULTSint - 枚举)(可选字段)
用户的排卵测试的结果,显示用户是否正在排卵。

血氧饱和度

此类型用于捕获血液中循环氧气含量,以氧饱和血糖的百分比表示。每个数据点表示测量时的单个血氧饱和度读数。

选填字段可让您添加任何补充氧气(如果进行了管理)的详细信息。

REST

Namecom.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

Namecom.google.oxygen_saturation
数据类型对象血氧饱和度
字段(格式 - 单位)
FIELD_OXYGEN_SATURATIONfloat - 百分比)
血氧饱和度读数(以百分比表示)。
FIELD_SUPPLEMENTAL_OXYGEN_FLOW_RATEfloat - 升/分钟)
向用户提供的附加氧气速(以升/分钟为单位)。零表示没有提供补充氧气,并且用户仅呼吸房间的空气。
FIELD_OXYGEN_TheRAPY_ADMINISTRATION_MODEint - 枚举)(可选字段)
氧气治疗的治疗方式。
可以不存在,如果是鼻腔给药,可以为 1
FIELD_OXYGEN_SATURATION_SYSTEMint - 枚举)(可选字段)
测量血氧饱和度。
可能不存在,如果使用外周毛细管测量,1
FIELD_OXYGEN_SATURATION_MEASUREMENT_METHODint - 枚举)(可选字段)
如何测量氧饱和度。
如果不存在脉搏血氧测量值,该值可能不存在,也可能为 1

睡眠

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

数据点的开始时间表示休眠阶段的开始时间,并且始终需要包含该开始时间。时间戳表示休眠阶段的结束时间。时间间隔不需要是连续的,但不应重叠。

REST

Namecom.google.sleep.segment
OAuth 权限范围
https://www.googleapis.com/auth/fitness.sleep.read
https://www.googleapis.com/auth/fitness.sleep.write
字段(格式 - 单位) 睡眠细分类型int - 枚举)
表示不同睡眠阶段和类型的值。

Android

Namecom.google.sleep.segment
数据类型对象TYPE_SLEEP_SEGMENT
字段(格式 - 单位) FIELD_SLEEP_SEGMENT_TYPEint - 枚举)
表示不同睡眠阶段和类型的值。

阴道点状出血

如果用户遇到点滴出血(月经周期之间出血),系统会记录这类数据。每个数据点都表示一个点位,因此每个点都应有一个时间戳,并且事件字段应设置为一个。

REST

Namecom.google.vaginal_spotting
OAuth 权限范围
https://www.googleapis.com/auth/fitness.reproductive_health.read
https://www.googleapis.com/auth/fitness.reproductive_health.write
字段(格式 - 单位)
方式int - 计数)
每次发现问题。将此字段设置为 1

Android

Namecom.google.vaginal_spotting
数据类型对象TYPE_VAGINAL_SPOTTING
字段(格式 - 单位)
FIELD_OCCURRENCESint - 计数)
每次发现问题。将此字段设置为 1

重量

此数据类型可捕获用户的体重(以千克为单位)。由于每个数据点都表示用户在读取时的权重,因此应仅设置结束时间。此值将用作读取操作的时间戳。

REST

Namecom.google.weight
OAuth 权限范围
https://www.googleapis.com/auth/fitness.body.read
https://www.googleapis.com/auth/fitness.body.write
字段(格式 - 单位) weightfloat-kg)
体重(千克)。
有效范围:0-1000 千克

Android

Namecom.google.weight
数据类型对象TYPE_WEIGHT
字段(格式 - 单位) FIELD_WEIGHTfloat-kg)
体重(千克)。
有效范围:0-1000 千克

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

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

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

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