健康数据类型

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 - 枚举)(选填字段)
读数与用户睡觉时间的对比。
样本来源int - 枚举)(选填字段)
用于测量血糖的体液类型。

Android

名称com.google.blood_glucose
数据类型对象TYPE_BLOOD_GLUCOSE
字段(格式 - 单位)
FIELD_BLOOD_GLUCOSE_LEVELfloat - 毫摩尔/升)
血糖水平或浓度,以毫摩尔/升为单位,其中 1 毫摩尔/升相当于 18 毫克/分升。
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 - 枚举)(可选字段)
测量时用户的身体位置。
measurement locationint - 枚举)(选填字段)
进行测量的哪支臂和哪支臂。

Android

名称com.google.blood_pressure
数据类型对象TYPE_BLOOD_PRESSURE
字段(格式 - 单位)
FIELD_BLOOD_PRESSURE_SYSTOLICfloat - mmHg)
收缩压测量值。
FIELD_BLOOD_PRESSURE_DIASTOLICfloat - 毫米汞)
舒张压测量。
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 - 摄氏度)
体温(以摄氏度为单位)。
measurement locationint - 枚举)(选填字段)
测量体温时所依据的用户身体部位。

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 - 枚举)(可选字段)
用户宫颈的开放程度或扩张程度。
cervical firmnessint - 枚举)(可选字段)
用户子宫颈的坚实程度。

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
字段(格式 - 单位) 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
字段(格式 - 单位) 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 - L/分钟)
向用户额外提供氧气的速率(以每分钟升为单位)。 零表示不提供补充供氧,且用户 只能呼吸到空气。
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
字段(格式 - 单位)
occurrencesint - 个计数)
每个检测到的广告。将此字段设置为 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
字段(格式 - 单位) weightfloat - 公斤)
体重,以公斤为单位。
有效范围:0—1000 公斤

Android

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

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

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

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

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