健康資料類型

Google Fit 會提供健康狀態資料類型,用於管理一般健康 (而非健身)。

資料類型清單

如要進一步瞭解健康資料類型及其欄位,請參閱 Android 參考說明文件。包含 enum 單位的欄位有可供選擇的值清單。請僅使用其中一個允許的值成功讀取及寫入資料。

血糖

這個資料類型會擷取血液中葡萄糖的濃度。每個資料點代表單一即時血糖讀數。進一步瞭解如何寫入血糖資料

REST

Namecom.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)
血糖水平或濃度 (mmmm/L),1 mmol/L 為 18 mg/dL。
temporal 與 meal 的關係 (int—列舉) (選用欄位)
測量時間
meal type (int:列舉) (選用欄位)
使用者朗讀書籍時須吃哪一類餐點。
暫時睡眠關係 (int:列舉) (選用欄位)
測量時間是使用者睡眠的時間。
樣本來源 (int:列舉) (選用欄位)
用於測量血糖的體液類型。

Android

Namecom.google.blood_glucose
資料類型物件TYPE_BLOOD_GLUCOSE
欄位 (格式 - 單位)
FIELD_BLOOD_GLUCOSE_LEVEL (float—mmol/L)
血糖水平或濃度 (mmmm/L),1 mmol/L 為 18 mg/dL。
FIELD_TEMPORAL_RELATION_TO_MEAL (int - 列舉) (選填欄位)
測量時間
FIELD_MEAL_TYPE (int - 列舉) (選填欄位)
使用者朗讀書籍時須吃哪一類餐點。
FIELD_TEMPORAL_RELATION_TO_SLEEP (int—列舉) (選用欄位)
測量時間是使用者睡眠的時間。
FIELD_BLOOD_GLUCOSE_SPECIMEN_SOURCE (int:列舉) (選填欄位)
用於測量血糖的體液類型。

血壓

這個資料類型會擷取使用者的血壓。每個資料點代表單一即時血壓讀取。進一步瞭解如何編寫血壓資料

REST

Namecom.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 - 列舉) (選用欄位)
測量時的主體位置。
measurement location (int - 列舉) (選用欄位)
測量的是哪個實驗組和哪一組。

Android

Namecom.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

Namecom.google.body.fat.percentage
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.body.read
https://www.googleapis.com/auth/fitness.body.write
欄位 (格式 - 單位) percentage (float—percent)
體脂肪總體重量百分比。
有效範圍:0–100%

Android

Namecom.google.body.fat.percentage
資料類型物件TYPE_BODY_FAT_PERCENTAGE
欄位 (格式 - 單位) FIELD_PERCENTAGE (float - 百分比)
體脂肪總體重量百分比。
有效範圍:0–100%

體溫

這個資料類型可擷取使用者的體溫。每個資料點都代表單一的即時體溫測量。

REST

Namecom.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 - 列舉) (選用欄位)
測量溫度的來源位於使用者的身體上。

Android

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

子宮頸黏液

這個資料類型會擷取子宮頸黏液說明。每個資料點都代表使用者自行評估的子宮頸黏液說明。所有欄位皆為選填,可用於描述子宮頸黏液的外觀和風格。

REST

Namecom.google.cervical_mucus
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.reproductive_health.read
https://www.googleapis.com/auth/fitness.reproductive_health.write
欄位 (格式 - 單位)
cervical mucus 紋理 (int:列舉) (選用欄位)
使用者子宮頸黏液的一致性或紋理。
cervmu mucus amount (int-enum) (選填欄位)
使用者觀察到的子宮頸黏液量。

Android

Namecom.google.cervical_mucus
資料類型物件TYPE_CERVical_MUCUS
欄位 (格式 - 單位)
FIELD_CERVICAL_MUCUS_TEXTURE (int - 列舉) (選填欄位)
使用者子宮頸黏液的一致性或紋理。
FIELD_CERVICAL_MUCUS_AMOUNT (int—列舉) (選用欄位)
使用者觀察到的子宮頸黏液量。

子宮頸位置

在這個資料類型中,每個資料點都代表使用者的 cervix 報告。所有欄位均為選填,可用於新增 cervix 的位置、展開方式和安全性。

REST

Namecom.google.cervical_position
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.reproductive_health.read
https://www.googleapis.com/auth/fitness.reproductive_health.write
欄位 (格式 - 單位)
cervical location (int:列舉) (選用欄位)
使用者子宮頸位置。
cervical dilation (int - 列舉) (選填欄位)
使用者的 cervix 的開放程度或如何擴大。
cervical 公司 (int:列舉) (選填欄位)
瞭解企業使用者 cervix 的表現。

Android

Namecom.google.cervical_position
資料類型物件TYPE_CERVARY_POSITION
欄位 (格式 - 單位)
FIELD_CERVICAL_POSITION (int - 列舉) (選填欄位)
使用者子宮頸位置。
FIELD_CERVICAL_DILATION (int:列舉) (選用欄位)
使用者的 cervix 的開放程度或如何擴大。
FIELD_CERVICAL_FIRMNESS (int - 列舉) (選填欄位)
使用者的 cervix 有多穩定。

心率

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

REST

Namecom.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 至 1,000

Android

Namecom.google.heart_rate.bpm
資料類型物件TYPE_HEART_RATE_BPM
Android 權限可錄製 BODY_SENSORS
欄位 (格式 - 單位) bpm (float-bpm)
每分鐘心跳數。
有效範圍:0 - 1000 bpm

高度

這個資料類型會擷取使用者的高度 (以公尺為單位)。由於每個資料點在讀取時代表使用者的高度,因此只需要設定結束時間。這會做為讀取作業的時間戳記。

REST

Namecom.google.height
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.body.read
https://www.googleapis.com/auth/fitness.body.write
欄位 (格式 - 單位) height (float - 公尺)
高度 (單位為公尺)。
有效範圍:0 - 3 公尺

Android

Namecom.google.height
資料類型物件TYPE_HEIGHT
欄位 (格式 - 單位) FIELD_HEIGHT (float - 公尺)
高度 (單位為公尺)。
有效範圍:0 - 3 公尺

經期

這個資料類型會擷取使用者的月經量 (點滴、光線、中等或重度) 描述。每個資料點都代表使用者月經出血的程度。

REST

Namecom.google.menstruation
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.reproductive_health.read
https://www.googleapis.com/auth/fitness.reproductive_health.write
欄位 (格式 - 單位)
menstrual Flow (int—列舉) (選用欄位)
使用者訂閱的期間長度。

Android

Namecom.google.menstruation
資料類型物件類型:男性
欄位 (格式 - 單位)
FIELD_MENSTRUAL_FLOW (int:列舉) (選用欄位)
使用者訂閱的期間長度。

排卵檢測

在這個資料類型中,每個資料點代表排卵測試 (正或負) 的二進位結果。

REST

Namecom.google.ovulation_test
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.reproductive_health.read
https://www.googleapis.com/auth/fitness.reproductive_health.write
欄位 (格式 - 單位)
排卵測試 (int:列舉) (選用欄位)
使用者排卵測試的結果,顯示使用者是否排卵。

Android

Namecom.google.ovulation_test
資料類型物件TYPE_OVULATION_TEST
欄位 (格式 - 單位)
FIELD_OVULATION_TEST_RESULT (int:列舉) (選用欄位)
使用者排卵測試的結果,顯示使用者是否排卵。

血氧濃度

這個資料類型會擷取血液中所含的氧氣量,以血氧飽和度血量的百分比測量。每個資料點代表測量時的單一血氧飽和度讀取。

如有需要,也能在選填的欄位中新增任何補充氧的詳細資料。

REST

Namecom.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

Namecom.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

Namecom.google.sleep.segment
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.sleep.read
https://www.googleapis.com/auth/fitness.sleep.write
欄位 (格式 - 單位) sleep 區隔類型 (int:列舉)
代表不同睡眠階段和類型的值。

Android

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

陰道點狀出血

這個類型會在使用者發現時 (擷取到兩次的期間) 擷取這個類型。每個資料點都代表一個 Spot 執行個體,因此每個資料點都應有時間戳記,而應將欄位設為 1。

REST

Namecom.google.vaginal_spotting
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.reproductive_health.read
https://www.googleapis.com/auth/fitness.reproductive_health.write
欄位 (格式 - 單位)
發生次數 (int-count)
每個 Spot 執行個體。將這個欄位設為 1

Android

Namecom.google.vaginal_spotting
資料類型物件TYPE_VAGINAL_SPOTTING
欄位 (格式 - 單位)
FIELD_OCCURRENCES (int—計數)
每個 Spot 執行個體。將這個欄位設為 1

重量

這個資料類型會擷取使用者的體重 (以公斤為單位)。由於每個資料點在讀取時都是使用者權重,因此只能設定結束時間。這會做為讀取作業的時間戳記。

REST

Namecom.google.weight
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.body.read
https://www.googleapis.com/auth/fitness.body.write
欄位 (格式 - 單位) weight (float - 公斤)
體重 (公斤)。
有效範圍:0 - 1000 公斤

Android

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

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

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

  1. 確認您的應用程式符合 Google 的 API 使用者資料政策和 Google Fit 開發人員和使用者資料政策。
  2. 申請同意畫面須經過 Google 驗證

應用程式經過驗證後,便可讀取使用者已同意讀取的健康資料。