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
|
| 欄位 (格式:單位) |
血糖值 (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—enum) (選用欄位)
與使用者進食時間相比,血糖讀數的測量時間。
接受的值
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 mmHg)
收縮壓測量值。
|
舒張壓 (float—mmHg)
舒張壓測量值。
|
身體位置 (int—列舉) (選填欄位)
測量時使用者的身體姿勢。
接受的值
"intVal": 1 // Standing up
"intVal": 2 // Sitting down
"intVal": 3 // Lying down
"intVal": 4 // Reclining
|
measurement location (int—enum) (選填欄位)
測量血壓的手臂和部位。
接受的值
"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 度)體溫 (攝氏)。
|
measurement location (int—enum) (選填欄位)
測量體溫的部位。
接受的值
"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—celsius)
體溫 (攝氏)。
|
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—enum) (選填欄位)
子宮頸的硬度。
接受的值
"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
|
| 欄位 (格式:單位) |
高度 (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—公升/分鐘)
以每分鐘公升數為單位,表示提供給使用者的額外氧氣量。如果未提供補充氧氣,且使用者僅呼吸室內空氣,請設為零。
|
氧氣治療管理模式 (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/min)
以每分鐘公升數為單位,表示提供給使用者的額外氧氣量。零表示未提供補充氧氣,使用者只呼吸室內空氣。
|
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—enum)
代表不同睡眠階段和類型的數值。
接受的值
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
|
| 欄位 (格式:單位) |
發生次數 (int—計數)
每個發現的執行個體。將這個欄位設為 1。
|
|
Android
| 名稱 | com.google.vaginal_spotting |
| 資料類型物件 | TYPE_VAGINAL_SPOTTING |
| 欄位 (格式:單位) |
FIELD_OCCURRENCES (int—count)
每個發現的執行個體。將這個欄位設為 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—kgs)
體重 (公斤)。
有效範圍:0 到 1000 公斤 |
取得健康資料的讀取和寫入權限
如要讀取健康資料,請按照下列步驟操作:
- 確認應用程式符合《Google API 使用者資料政策》和 Google Fit 開發人員與使用者資料政策。
申請通過 Google 驗證同意畫面。
應用程式通過驗證後,即可讀取使用者同意讀取的健康資料。