Google Fit API (包括 Google Fit REST API) 將於 2025 年 6 月 30 日後停止服務。自 2024 年 5 月 1 日起，開發人員無法申請使用這些 API。

如要瞭解要遷移至哪個 API 或平台，請參閱 Health Connect 遷移指南。如需 Health Connect 、 Google Fit API 和 Fitbit Web API 的比較，請參閱 Health Connect 比較指南。

進一步瞭解 Health Connect，以及如何與 API 整合。

本頁面由 Cloud Translation API 翻譯而成。

健康資料類型

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 會評估相關風險並套用配額。您的使用者也可能會看到警告畫面。你仍然可以測試應用程式，但配額會限制您可獲得的新使用者數量。

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