健康数据类型

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 mmol/L 等于 18 mg/dL。
与餐食的时间关系int - 枚举)(可选字段)
血糖读数是在用户进食前还是进食后测量的。
餐点类型int - 枚举)(可选字段)
用户在测量血糖值前后所吃的餐食类型。
与睡眠的时间关系int - 枚举)(可选字段)
与用户睡眠时间相比,测量血压的时间。
specimen sourceint - 枚举)(可选字段)
用于测量血糖的体液类型。

Android

名称com.google.blood_glucose
数据类型对象TYPE_BLOOD_GLUCOSE
字段(格式 - 单位)
FIELD_BLOOD_GLUCOSE_LEVELfloat 毫摩尔/升)
以 mmol/L 为单位的血糖水平或浓度,其中 1 mmol/L 等于 18 mg/dL。
FIELD_TEMPORAL_RELATION_TO_MEALint - 枚举)(可选字段)
血糖读数是在用户进食前还是进食后测量的。
FIELD_MEAL_TYPEint - 枚举)(可选字段)
用户在测量血糖值前后所吃的餐食类型。
FIELD_TEMPORAL_RELATION_TO_SLEEPint - 枚举)(可选字段)
与用户睡眠时间相比,测量血压的时间。
FIELD_BLOOD_GLUCOSE_SPECIMEN_SOURCEint - 枚举)(可选字段)
用于测量血糖的体液类型。

血压

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

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-毫米汞柱)
收缩压测量值。
舒张压float—毫米汞柱)
舒张压测量值。
身体位置int - 枚举)(可选字段)
测量时的用户身体姿势。
测量位置int - 枚举)(可选字段)
测量时所用的手臂和手臂部位。

Android

名称com.google.blood_pressure
数据类型对象TYPE_BLOOD_PRESSURE
字段(格式 - 单位)
FIELD_BLOOD_PRESSURE_SYSTOLICfloat - mmHg)
收缩压测量值。
FIELD_BLOOD_PRESSURE_DIASTOLICfloat - mmHg)
舒张压测量值。
FIELD_BODY_POSITIONint - 枚举)(可选字段)
测量时的用户身体姿势。
FIELD_BLOOD_PRESSURE_MEASUREMENT_LOCATIONint - 枚举)(可选字段)
测量时所用的手臂和手臂部位。

身体脂肪百分比

此类数据用于捕获用户的体脂率。每个数据点表示某人的总体脂占其总体重的百分比。

REST

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

Android

名称com.google.body.fat.percentage
数据类型对象TYPE_BODY_FAT_PERCENTAGE
字段(格式 - 单位) FIELD_PERCENTAGEfloat - 百分比)
体脂占总体重的百分比。
有效范围: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 - 枚举)(可选字段)
用户身体的哪个部位用于测量体温。

Android

名称com.google.body.temperature
数据类型对象TYPE_BODY_TEMPERATURE
字段(格式 - 单位)
FIELD_BODY_TEMPERATUREfloat - 摄氏度)
体温(以摄氏度为单位)。
FIELD_BODY_TEMPERATURE_MEASUREMENT_LOCATIONint - 枚举)(可选字段)
用户身体的哪个部位用于测量体温。

宫颈粘液

此数据类型用于捕获宫颈粘液的描述。每个数据点都表示用户对宫颈黏液的自我评估描述。所有字段均为选填,可用于描述宫颈粘液的外观、感觉和量。

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 - 枚举)(可选字段)
用户宫颈粘液的稠度或质地。
宫颈粘液量int - 枚举)(可选字段)
用户观察到的宫颈粘液量。

Android

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

宫颈位置

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

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 - 枚举)(可选字段)
用户子宫颈的位置。
宫颈扩张int - 枚举)(可选字段)
用户的宫颈张开或扩张程度。
宫颈硬度int - 枚举)(可选字段)
用户子宫颈的硬度。

Android

名称com.google.cervical_position
数据类型对象TYPE_CERVICAL_POSITION
字段(格式 - 单位)
FIELD_CERVICAL_POSITIONint - 枚举)(可选字段)
用户子宫颈的位置。
FIELD_CERVICAL_DILATIONint - 枚举)(可选字段)
用户的宫颈张开或扩张程度。
FIELD_CERVICAL_FIRMNESSint - 枚举)(可选字段)
用户子宫颈的硬度。

心率

这类数据用于捕获用户的心率(以每分钟心跳次数为单位)。由于每个数据点都表示瞬时心率测量值,因此只需设置结束时间。这将用作读数的时间戳。

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
字段(格式 - 单位) 每分钟心跳次数float - 每分钟心跳次数)
心率(每分钟心跳次数)。
有效范围:0-1000

Android

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

高度

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

REST

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

Android

名称com.google.height
数据类型对象TYPE_HEIGHT
字段(格式 - 单位) FIELD_HEIGHTfloat 米)
高度(以米为单位)。
有效范围: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 - 枚举)(可选字段)
用户经期的经量。

Android

名称com.google.menstruation
数据类型对象TYPE_MENSTRUATION
字段(格式 - 单位)
FIELD_MENSTRUAL_FLOWint - 枚举)(可选字段)
用户经期的经量。

排卵检测

在此数据类型中,每个数据点都表示排卵测试的二元结果(阳性或阴性)。

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 - 枚举)(可选字段)
用户的排卵测试结果,显示用户是否正在排卵。

Android

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

血氧饱和度

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

您还可以在可选字段中添加有关任何辅助供氧(如有)的详细信息。

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 升/分钟)
以升/分钟为单位向用户输送额外氧气的速率。 如果未提供辅助供氧,且用户仅呼吸室内空气,则设置为零。
氧气疗法管理模式int - 枚举)(可选字段)
氧气疗法的给氧方式。
如果通过鼻导管给药,则可以缺省或为 1
血氧饱和度系统int - 枚举)(可选字段)
测量血氧饱和度的位置。
如果是在外周毛细血管中测量,则可以缺省或为 1
血氧饱和度测量方法int - 枚举)(可选字段)
血氧饱和度的测量方式。
如果通过脉搏血氧测定法测量,则可以缺省或为 1

Android

名称com.google.oxygen_saturation
数据类型对象TYPE_OXYGEN_SATURATION
字段(格式 - 单位)
FIELD_OXYGEN_SATURATIONfloat - 百分比)
血氧饱和度读数,以百分比表示。
FIELD_SUPPLEMENTAL_OXYGEN_FLOW_RATEfloat - 升/分钟)
以升/分钟为单位向用户输送额外氧气的速率。 0 表示未提供辅助供氧,用户仅呼吸室内空气。
FIELD_OXYGEN_THERAPY_ADMINISTRATION_MODEint - 枚举)(可选字段)
氧气疗法的给氧方式。
如果通过鼻导管给药,则可以缺省或为 1
FIELD_OXYGEN_SATURATION_SYSTEMint - 枚举)(可选字段)
测量血氧饱和度的位置。
如果是在外周毛细血管中测量,则可以缺省或为 1
FIELD_OXYGEN_SATURATION_MEASUREMENT_METHODint - 枚举)(可选字段)
血氧饱和度的测量方式。
如果通过脉搏血氧测定法测量,则可以缺省或为 1

睡眠

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

数据点的开始时间表示睡眠阶段的开始时间,必须始终包含。时间戳表示睡眠阶段的结束时间。时间间隔无需连续,但不应重叠。

REST

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

Android

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

阴道点状出血

此数据类型用于记录用户是否出现点滴出血(经期之间的出血)。每个数据点都表示一个发现实例,因此每个点都应具有时间戳,并且“出现次数”字段应设置为 1。

REST

名称com.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

名称com.google.vaginal_spotting
数据类型对象TYPE_VAGINAL_SPOTTING
字段(格式 - 单位)
FIELD_OCCURRENCESint - 数量)
每次发现。将此字段设置为 1

重量

这类数据用于捕获用户的体重(以千克为单位)。由于每个数据点都表示用户在读数时的体重,因此只需设置结束时间。这将用作读数的时间戳。

REST

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

Android

名称com.google.weight
数据类型对象TYPE_WEIGHT
字段(格式 - 单位) FIELD_WEIGHTfloat - 千克)
体重(以千克为单位)。
有效范围:0-1000 公斤

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

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

  1. 确保您的应用符合 Google 的 API 用户数据政策以及 Google 健身开发者和用户数据政策。
  2. 申请让 Google 验证您的权限请求页面。

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