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 - 枚举)(可选字段)
血糖读数是在用户进食前还是进食后测量的。
已接受的值
"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
|
specimen source(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 为单位的血糖水平或浓度,其中 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
|
| 字段(格式 - 单位) |
收缩压(float-毫米汞柱)
收缩压测量值。
|
舒张压(float—毫米汞柱)
舒张压测量值。
|
身体位置(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
|
| 字段(格式 - 单位) |
百分比(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
|
| 字段(格式 - 单位) |
每分钟心跳次数(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
|
| 字段(格式 - 单位) |
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
|
| 字段(格式 - 单位) |
月经流量(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 升/分钟)
以升/分钟为单位向用户输送额外氧气的速率。
如果未提供辅助供氧,且用户仅呼吸室内空气,则设置为零。
|
氧气疗法管理模式(int - 枚举)(可选字段)
氧气疗法的给氧方式。
如果通过鼻导管给药,则可以缺省或为 1。
|
血氧饱和度系统(int - 枚举)(可选字段)
测量血氧饱和度的位置。
如果是在外周毛细血管中测量,则可以缺省或为 1。
|
血氧饱和度测量方法(int - 枚举)(可选字段)
血氧饱和度的测量方式。
如果通过脉搏血氧测定法测量,则可以缺省或为 1。
|
|
Android
| 名称 | com.google.oxygen_saturation |
| 数据类型对象 | TYPE_OXYGEN_SATURATION |
| 字段(格式 - 单位) |
FIELD_OXYGEN_SATURATION(float - 百分比)
血氧饱和度读数,以百分比表示。
|
FIELD_SUPPLEMENTAL_OXYGEN_FLOW_RATE(float - 升/分钟)
以升/分钟为单位向用户输送额外氧气的速率。
0 表示未提供辅助供氧,用户仅呼吸室内空气。
|
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.
|
阴道点状出血
此数据类型用于记录用户是否出现点滴出血(经期之间的出血)。每个数据点都表示一个发现实例,因此每个点都应具有时间戳,并且“出现次数”字段应设置为 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_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 千克)
体重(以千克为单位)。
有效范围:0-1000 公斤 |
Android
| 名称 | com.google.weight |
| 数据类型对象 | TYPE_WEIGHT |
| 字段(格式 - 单位) |
FIELD_WEIGHT(float - 千克)
体重(以千克为单位)。
有效范围:0-1000 公斤 |
获取健康数据读取和写入权限
如需读取健康数据,请按以下步骤操作:
- 确保您的应用符合 Google 的 API 用户数据政策以及 Google 健身开发者和用户数据政策。
申请让 Google 验证您的权限请求页面。
如果您的应用通过验证,则可以读取用户同意被读取的健康数据。