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)
血糖水平或浓度以 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
样本来源 (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)
血糖水平或浓度以 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
字段(格式 - 单位)
systolic (float
-mmHg)
收缩压测量。
舒张压 (float
-mmHg)
舒张压测量。
body position (int
- 枚举)(选填字段)
进行测量时用户的身体位置。
已接受的值
"intVal": 1 // Standing up
"intVal": 2 // Sitting down
"intVal": 3 // Lying down
"intVal": 4 // Reclining
measurement location (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
—摄氏度)
体温(以摄氏度为单位)。
measurement location (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
字段(格式 - 单位)
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
字段(格式 - 单位)
menstrual flow (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
字段(格式 - 单位)
weight (float
-kgs)
体重,以公斤为单位。
有效范围 :0—1000 公斤
Android
名称 com.google.weight
数据类型对象 TYPE_WEIGHT
字段(格式 - 单位)
FIELD_WEIGHT (float
- 千克)
体重,以公斤为单位。
有效范围 :0—1000 公斤
获取读取和写入健康数据的权限
如需读取健康数据,请按以下步骤操作:
确保您的应用符合 Google 的 API 用户数据政策 以及 Google 健身开发者和用户数据政策。
您可申请由 Google 验证 您的同意屏幕。
注意 :如果您的应用在请求访问敏感的
OAuth 范围,Google 将评估其风险并应用
配额 。您的
用户还可能会看到警告屏幕 。您仍然可以
测试您的应用,但配额会限制您可以获得的新用户数。
如果您的应用通过验证,就可以读取用户已同意读取的健康数据。