健康資料類型

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 為 18/L) 為 18 mg/dL。
暫時關係 (int:列舉) (選填欄位)
讀取時間與使用者退房時間。
meal type (int:列舉) (選填欄位)
系統測量讀數時,使用者會吃的料理類型。
與睡眠時間的時間關係 (int—enum) (選用欄位)
測量讀數與使用者的睡眠時間。
規格來源 (int:列舉) (選填欄位)
用於測量血糖的體液類型。

Android

名稱com.google.blood_glucose
資料類型物件TYPE_BLOOD_GLUCOSE
欄位 (格式:units)
FIELD_BLOOD_GLUCOSE_LEVEL (float - mmol/L)
血糖水平或濃度,以 mmol/L 為單位,1 mmol/L 等於 18 mg/dL。
FIELD_TEMPORAL_RELATION_TO_MEAL (int—列舉) (選用欄位)
讀取時間與使用者退房時間。
FIELD_MEAL_TYPE (int—enum) (選用欄位)
系統測量讀數時,使用者會吃的料理類型。
FIELD_TEMPORAL_RELATION_TO_SLEEP (int—enum) (選用欄位)
與使用者睡眠時間相比,讀數的測量時間。
FIELD_BLOOD_GLUCOSE_SPECIMEN_SOURCE (int—列舉) (選填欄位)
用於測量血糖的體液類型。

血壓

這個資料類型會擷取使用者的血壓。每個資料點代表 單次的瞬間血壓讀數。進一步瞭解如何寫血 壓力資料

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)
收縮壓 (float-mmHg)
收縮壓測量結果。
舒張壓 (float-mmHg)
舒張壓測量值。
body position (int—列舉) (選填欄位)
使用者測量時的身體姿勢。
measurement location (int—enum) (選用欄位)
測量的實驗組和別的部臂。

Android

名稱com.google.blood_pressure
資料類型物件TYPE_BLOOD_PRESSURE
欄位 (格式 - 單位)
FIELD_BLOOD_PRESSURE_SYSTOLIC (float—mmHg)
收縮壓測量結果。
FIELD_BLOOD_PRESSURE_DIASTOLIC (float - mmHg)
舒張壓測量值。
FIELD_BODY_POSITION (int:列舉) (選用欄位)
測量期間的使用者身體位置。
FIELD_BLOOD_PRESSURE_MEASUREMENT_LOCATION (int,列舉) (選用欄位)
測量的實驗組和別的部臂。

體脂肪百分比

這個資料類型會擷取使用者的體脂肪百分比。每個資料點代表某人的總體脂肪占總身體質量的百分比。

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
欄位 (格式 - 單位) 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) (選用欄位)
測量溫度在使用者身體上的位置。

Android

名稱com.google.body.temperature
資料類型物件TYPE_BODY_TEMPERATURE
欄位 (格式 - 單位)
FIELD_BODY_TEMPERATURE (float—攝氏)
體溫 (攝氏度)。
FIELD_BODY_TEMPERATURE_MEASUREMENT_LOCATION (int—列舉) (選用欄位)
使用者身體上測量體溫的位置。

子宮頸黏液

這個資料類型會擷取子宮頸黏液的說明。每個資料點 代表針對使用者的子宮頸黏液自我評估說明。所有欄位 為選用,可用來描述子宮頸黏液的外觀和風格 和金額

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—列舉) (選填欄位)
使用者子宮頸黏液的規律或紋理。
子宮頸黏液量 (int-enum) (選用欄位)
使用者觀察到多少子宮頸黏液。

Android

名稱com.google.cervical_mucus
資料類型物件TYPE_CERVICAL_MUCUS
欄位 (格式:units)
FIELD_CERVICAL_MUCUS_TEXTURE (int—enum) (選用欄位)
使用者子宮頸黏液的規律或紋理。
FIELD_CERVICAL_MUCUS_AMOUNT (int—enum) (選填欄位)
使用者觀察的子宮頸黏液。

子宮頸位置

在此資料類型中,每個資料點都代表使用者的 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)
子宮頸位置 (int-enum) (選用欄位)
使用者的憑證位置。
cervical dilation (int—列舉) (選用欄位)
使用者的 Cervix 開啟或關閉程度。
cervicalFirmness (int-enum) (選用欄位)
使用者的子宮頸有多緊。

Android

名稱com.google.cervical_position
資料類型物件TYPE_CERVICAL_POSITION
欄位 (格式 - 單位)
FIELD_CERVICAL_POSITION (int:列舉) (選用欄位)
使用者子宮頸的位置。
FIELD_CERVICAL_DILATION (int—enum) (選用欄位)
使用者的 Cervix 開啟或關閉程度。
FIELD_CERVICAL_FIRMNESS (int—enum) (選用欄位)
使用者的心房顫動程度。

心率

這個資料類型會擷取使用者的心率 (以每分鐘心跳數為單位)。由於每個資料點都代表心率的即時測量值,因此只需設定結束時間。這會做為讀取作業的時間戳記。

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即可錄音
欄位 (格式: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) 高度 (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—enum) (選用欄位)
使用者月經的運轉程度。

Android

名稱com.google.menstruation
資料類型物件TYPE_MENSTRUATION
欄位 (格式 - 單位)
FIELD_MENSTRUAL_FLOW (int—enum) (選填欄位)
使用者的經期量。

排卵測試

在這個資料類型中,每個資料點都代表排卵的二元結果 測試 (例如正面或負面)。

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
欄位 (格式:units)
FIELD_OVULATION_TEST_RESULT (int,列舉) (選用欄位)
使用者的排卵檢測結果,顯示使用者是否正在排卵。

血氧濃度

這個資料類型會擷取血液中循環的氧氣量,以血液中血紅素飽和氧氣的百分比為單位。每個資料點代表測量時的單一血氧飽和度讀數。

也可在選擇性的欄位中加入補充氧氣的詳細資料 (如果情況的話) 管理。

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—列舉) (選填欄位)
氧氣療法的管理方式。
使用鼻管給藥時,可省略或 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—列舉) (選用欄位)
氧氣治療的施用方式。
如果由 Nasal Canula 管理,則可能不存在,或 1
FIELD_OXYGEN_SATURATION_SYSTEM (int—enum) (選用欄位)
血氧濃度測量位置。
如果在周邊微血管測量,可能會缺少或 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) sleep segment type (int—enum)
代表不同睡眠階段和類型的值。

Android

名稱com.google.sleep.segment
資料類型物件TYPE_SLEEP_SEGMENT
欄位 (格式 - 單位) FIELD_SLEEP_SEGMENT_TYPE (int,列舉)
代表不同睡眠階段和類型的值。

陰道點狀出血

這類資料會記錄使用者是否有點狀出血 (在經期之間出血)。每個資料點代表一個觀測例項,因此每個點都應有時間戳記,且「發生次數」欄應設為 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
欄位 (格式 - 單位)
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
欄位 (格式 - 單位) weight (float 至 公斤)
身體體重 (單位為公斤)。
有效範圍:0 到 1000 公斤

Android

名稱com.google.weight
資料類型物件TYPE_WEIGHT
欄位 (格式 - 單位) FIELD_WEIGHT (float—公斤)
體重 (公斤)。
有效範圍:0 到 1000 公斤

取得讀取及寫入健康資料的權限

如要讀取健康資料,請按照下列步驟操作:

  1. 確認您的應用程式遵循 Google API 使用者資料政策和 Google Fit 開發人員與使用者資料政策。
  2. 申請讓您的同意畫面通過 Google 驗證

如果應用程式通過驗證,就能讀取使用者同意讀取的健康資料。