健康資料類型

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
欄位 (format—units)
血糖濃度 (float—mmol/L)
血糖水平或濃度 (以 mmol/L 為單位),其中 1 mmol/L 為 18 mg/dL。
暫時關係 (int:列舉) (選填欄位)
比較讀書的時間與使用者入住的時間。
飲食類型 (int:列舉) (選填欄位)
使用者在閱讀讀物時吃了什麼類型的餐點。
與睡眠間的關係 (int:列舉) (選填欄位)
比較讀數與使用者入睡的時間。
specimen source (int:列舉) (選填欄位)
用於測量血糖的體液類型。

Android

名稱com.google.blood_glucose
資料類型物件TYPE_BLOOD_GLUCOSE
欄位 (format—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:列舉) (選填欄位)
使用者在閱讀讀物時吃了什麼類型的餐點。
FIELD_TEMPORAL_RELATION_TO_SLEEP (int,列舉) (選填欄位)
比較讀數與使用者入睡的時間。
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
欄位 (format—units)
收縮壓 (float—mmHg)
收縮壓。
舒張壓 (float—mmHg)
舒張壓測量。
body 位置 (int:列舉) (選填欄位)
測量結果的使用者身體位置。
測量位置 (int:列舉) (選填欄位)
測量的組別和組成部分。

Android

名稱com.google.blood_pressure
資料類型物件TYPE_BLOOD_PRESSURE
欄位 (format—units)
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
欄位 (format—units) percentage (float—百分比)
體脂肪總量的百分比。
有效範圍:0 至 100%

Android

名稱com.google.body.fat.percentage
資料類型物件TYPE_BODY_FAT_PERCENTAGE
欄位 (format—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
欄位 (format—units)
體溫 (float:攝氏)
體溫 (攝氏度)。
測量位置 (int:列舉) (選填欄位)
測量溫度的使用者身體哪個位置。

Android

名稱com.google.body.temperature
資料類型物件TYPE_BODY_TEMPERATURE
欄位 (format—units)
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
欄位 (format—units)
子宮頸黏液紋理 (int:列舉) (選填欄位)
使用者子宮頸黏液的一致性或紋理。
cervical mucus amount (int:列舉) (選填欄位)
使用者觀察到的子宮頸黏液量。

Android

名稱com.google.cervical_mucus
資料類型物件TYPE_CERVICAL_MUCUS
欄位 (format—units)
FIELD_CERVICAL_MUCUS_TEXTURE (int:列舉) (選填欄位)
使用者子宮頸黏液的一致性或紋理。
FIELD_CERVICAL_MUCUS_AMOUNT (int—列舉) (選填欄位)
使用者觀察到的子宮頸黏液量。

子宮頸位置

在這個資料類型中,每個資料點都代表一份有關使用者報告的報告。所有欄位皆為選填,可用來新增有關乳癌位置、除法和緊實度的說明。

REST

名稱com.google.cervical_position
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.reproductive_health.read
https://www.googleapis.com/auth/fitness.reproductive_health.write
欄位 (format—units)
cervical position (int:列舉) (選填欄位)
使用者憑證的位置。
cervical dilation (int:列舉) (選填欄位)
使用者的禮節程度如何,
cervical firmness (int:列舉) (選填欄位)
使用者的滿意度為何。

Android

名稱com.google.cervical_position
資料類型物件TYPE_CERVICAL_POSITION
欄位 (format—units)
FIELD_CERVICAL_POSITION (int,列舉) (選填欄位)
使用者憑證的位置。
FIELD_CERVICAL_DILATION (int,列舉) (選填欄位)
使用者的禮節程度如何,
FIELD_CERVICAL_FIRMNESS (int—列舉) (選填欄位)
使用者的禮節程度。

心率

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

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
欄位 (format—units) bpm (float—bpm)
心率,單位為每分鐘心跳數。
有效範圍:0 至 1000

Android

名稱com.google.heart_rate.bpm
資料類型物件TYPE_HEART_RATE_BPM
Android 權限BODY_SENSORS即可錄製
欄位 (format—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
欄位 (format—units) height (float—公尺)
身高 (單位為公尺)。
有效範圍:0 至 3 公尺

Android

名稱com.google.height
資料類型物件TYPE_HEIGHT
欄位 (format—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
欄位 (format—units)
menstrual Flow (int—列舉) (選填欄位)
使用者的月經週期有多大。

Android

名稱com.google.menstruation
資料類型物件TYPE_MENSTRUATION
欄位 (format—units)
FIELD_MENSTRUAL_FLOW (int—列舉) (選填欄位)
使用者的月經週期有多大。

排卵檢測

在此資料類型中,每個資料點都代表排卵檢測的二元結果 (陽性或負數)。

REST

名稱com.google.ovulation_test
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.reproductive_health.read
https://www.googleapis.com/auth/fitness.reproductive_health.write
欄位 (format—units)
排卵測試 (int,列舉) (選填欄位)
使用者的排卵檢測結果,顯示他們是否正在排卵。

Android

名稱com.google.ovulation_test
資料類型物件TYPE_OVULATION_TEST
欄位 (format—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
欄位 (format—units)
氧飽和度 (float—百分比)
血氧飽和度讀數百分比。
有效範圍:0 至 100%
氧氣補充流量 (float - L/分鐘)
系統會將心率的額外氧氣設備 (以公升為單位) 提供給使用者。如果沒有提供補充氧氣,且使用者只有呼吸室,請設為零。
oxygen 療法管理模式 (int:列舉) (選填欄位)
氧氣療法的管理方式。
可能為沒人或 1,如果是由鼻腔控制系統所管理。
oxygen saturation system (int - 列舉) (選填欄位)
血氧濃度測量的位置。
如果以周邊毛細血管測量,則可省略或 1
氧飽和度測量方法 (int:列舉) (選填欄位)
如何測量氧飽和度。
可為缺少或由脈搏血氧測量測出的 1

Android

名稱com.google.oxygen_saturation
資料類型物件TYPE_OXYGEN_SATURATION
欄位 (format—units)
FIELD_OXYGEN_SATURATION (float—百分比)
血氧飽和度讀數百分比。
FIELD_SUPPLEMENTAL_OXYGEN_FLOW_RATE (float—L/min)
系統會將心率的額外氧氣設備 (以公升為單位) 提供給使用者。0 表示未提供補充氧氣,且使用者只會呼吸室內空氣。
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
欄位 (format—units) 睡眠區隔類型 (int:列舉)
值代表不同的睡眠階段和類型。

Android

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

陰道點狀出血

如果使用者有發生異常情況 (在經期之間出現),此資料類型就會擷取。每個資料點都代表一個點狀記錄,因此每個資料點都應該有時間戳記,而且發生次數欄位應設為一個。

REST

名稱com.google.vaginal_spotting
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.reproductive_health.read
https://www.googleapis.com/auth/fitness.reproductive_health.write
欄位 (format—units)
occurrences (int:計數)
每次發現。將這個欄位設為 1

Android

名稱com.google.vaginal_spotting
資料類型物件TYPE_VAGINAL_SPOTTING
欄位 (format—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
欄位 (format—units) weight (float — 公斤)
身體體重 (公斤)。
有效範圍:0 至 1000 公斤

Android

名稱com.google.weight
資料類型物件TYPE_WEIGHT
欄位 (format—units) FIELD_WEIGHT (float — 公斤)
身體體重 (公斤)。
有效範圍:0 至 1000 公斤

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

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

  1. 確認您的應用程式符合《Google API 使用者資料政策》以及《Google Fit 開發人員和使用者資料政策》的規定。
  2. 申請同意畫面,以便通過 Google 驗證

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