Google Fit 提供與管理相關的健康資料類型
與一般健康相關。
資料類型清單
如要進一步瞭解健康資料類型及其欄位,請前往
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
欄位 (格式:units)
血糖濃度 (float
—mmol/L)
血糖水平或濃度 (mmol/L 為 18/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
meal type (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
欄位 (格式:units)
FIELD_BLOOD_GLUCOSE_LEVEL (float
- mmol/L)
血糖水平或濃度 (mmol/L 為 18/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
欄位 (格式:units)
systolic (float
- mmHg)
收縮壓測量結果。
舒張壓 (float
- mmHg)
舒張壓測量值。
body position (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
欄位 (格式:units)
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
欄位 (格式:units)
percentage (float
:百分比)
體脂肪總量百分比。
有效範圍 :0 至 100%
Android
名稱 com.google.body.fat.percentage
資料類型物件 TYPE_BODY_FAT_PERCENTAGE
欄位 (格式:units)
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
欄位 (格式:units)
體溫 (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
欄位 (格式:units)
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
欄位 (格式:units)
子宮頸黏液紋理 (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
欄位 (格式:units)
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
子宮頸位置
在此資料類型中,每個資料點都代表使用者的 Cervix 報表。所有語言
欄位為選填,可用來添加位置說明
典禮的冷卻與硬度。
REST
名稱 com.google.cervical_position
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.reproductive_health.read
https://www.googleapis.com/auth/fitness.reproductive_health.write
欄位 (格式:units)
cervical position (int
—列舉) (選填欄位)
使用者的憑證位置。
接受的值
"intVal": 1 // Cervix is low
"intVal": 2 // Cervix is in a medium position
"intVal": 3 // Cervix is high
cervical dilation (int
—列舉) (選用欄位)
使用者的 Cervix 開啟或關閉程度。
接受的值
"intVal": 1 // Closed cervix
"intVal": 2 // Partially open cervix
"intVal": 3 // Fully dilated, open cervix
子宮頸硬度 (int
—列舉) (選填欄位)
使用者的 cervix 狀態
接受的值
"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
欄位 (格式:units)
FIELD_CERVICAL_POSITION (int
:列舉) (選用欄位)
使用者的憑證位置。
接受的值
CERVICAL_POSITION_LOW
CERVICAL_POSITION_MEDIUM
CERVICAL_POSITION_HIGH
FIELD_CERVICAL_DILATION (int
,列舉) (選用欄位)
使用者的 Cervix 開啟或關閉程度。
接受的值
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
欄位 (格式:units)
bpm (float
- bpm)
心率,單位為每分鐘心跳數。
有效範圍 :0 至 1000
Android
名稱 com.google.heart_rate.bpm
資料類型物件 TYPE_HEART_RATE_BPM
Android 權限 BODY_SENSORS
即可錄音
欄位 (格式:units)
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
欄位 (格式:units)
height (float
:公尺)
高度 (單位為公尺)。
有效範圍 :0 到 3 公尺
Android
名稱 com.google.height
資料類型物件 TYPE_HEIGHT
欄位 (格式:units)
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
欄位 (格式:units)
月經流程 (int
—列舉) (選填欄位)
使用者月經的運轉程度。
接受的值
"intVal": 1 // Spotting
"intVal": 2 // Light
"intVal": 3 // Medium
"intVal": 4 // Heavy
Android
名稱 com.google.menstruation
資料類型物件 TYPE_MENSTRUATION
欄位 (格式:units)
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
欄位 (格式:units)
排卵測試 (int
:列舉) (選填欄位)
使用者的排卵檢測結果,顯示使用者是否正在排卵。
接受的值
"intVal": 1 // Negative
"intVal": 2 // Positive
Android
名稱 com.google.ovulation_test
資料類型物件 TYPE_OVULATION_TEST
欄位 (格式:units)
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
欄位 (格式:units)
血氧濃度 (float
—百分比)
血氧飽和度讀數百分比。
有效範圍 :0 至 100%
血氧濃度補充率 (float
- L/分鐘)
額外的氧氣是由使用者以每分鐘公升為單位。
如未提供補充氧氣,且使用者
只能放送空氣
氧氣療法管理模式 (int
—列舉) (選填欄位)
氧氣療法的管理方式。
如果由 Nasal Canula 管理,則可能不存在,或 1
。
氧飽和度系統 (int
—列舉) (選用欄位)
用於測量氧飽和度的位置。
如果測量單位為週邊裝置,可能會缺少值,或者是 1
。
氧飽和度測量方法 (int
—列舉) (選填欄位)
如何測量氧飽和度。
如果計算的是脈搏血氧濃度,可能就不會顯示為 1
。
Android
名稱 com.google.oxygen_saturation
資料類型物件 TYPE_OXYGEN_SATURATION
欄位 (格式:units)
FIELD_OXYGEN_SATURATION (float
—百分比)
血氧飽和度讀數百分比。
FIELD_SUPPLEMENTAL_OXYGEN_FLOW_RATE (float
- L/分鐘)
額外的氧氣是由使用者以每分鐘公升為單位。
0 表示未提供補充氧氣,而使用者
只能放送空氣
FIELD_OXYGEN_THERAPY_ADMINISTRATION_MODE (int
—列舉) (選用欄位)
氧氣療法的管理方式。
如果由 Nasal Canula 管理,則可能不存在,或 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
欄位 (格式:units)
睡眠區隔類型 (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
欄位 (格式:units)
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
欄位 (格式:units)
occurrences (int
—數量)
每個點狀出血的情況。將這個欄位設為 1
。
Android
名稱 com.google.vaginal_spotting
資料類型物件 TYPE_VAGINAL_SPOTTING
欄位 (格式:units)
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
欄位 (格式:units)
weight (float
至 公斤)
身體體重 (單位為公斤)。
有效範圍 :0 到 1000 公斤
Android
名稱 com.google.weight
資料類型物件 TYPE_WEIGHT
欄位 (格式:units)
FIELD_WEIGHT (float
- 公斤)
身體體重 (單位為公斤)。
有效範圍 :0 到 1000 公斤
取得讀取及寫入健康資料的權限
如要讀取健康資料,請按照下列步驟操作:
確認您的應用程式符合 Google API 使用者資料政策 和 Google Fit 開發人員和使用者資料政策。
為您的同意畫面申請 Google 驗證 。
注意: 如果您的應用程式要求存取敏感內容,但未通過驗證
OAuth 範圍,Google 會評估相關風險並套用
配額 。您的
使用者也可能會看到警告畫面 。你仍然可以
測試應用程式,但配額會限制您可獲得的新使用者數量。
如果您的應用程式通過驗證,就能讀取使用者同意讀取的健康資料。