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 翻譯而成。

活動資料類型

這些資料類型可用於擷取活動、健身和指標相關運動。

活動

這個資料類型可用來擷取使用者進行的任何活動。可用的值包括常見健身活動，例如跑步或不同運動，以及冥想、園藝和睡眠等活動。

如果使用者在這段時間內進行了多項活動，請建立工作階段，以及不同活動類型的多個區隔。舉例來說，如果他們在混合武術的表現，會稍微調整拳擊和拳擊課程，建立混合武術的課程。再按把活動類型劃分為區隔

每個資料點都必須設定開始時間和結束時間。資料點不必當中的兩個環節可能相差不多。

REST

名稱	`com.google.activity.segment`
OAuth 權限範圍	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
欄位 (格式：units)	活動類型 (`int`，列舉) 使用者進行的活動類型。如要查看活動類型清單，請按這裡。

Android

名稱	`com.google.activity.segment`
資料類型物件	`TYPE_ACTIVITY_SEGMENT`
Android 權限	`ACTIVITY_RECOGNITION`
欄位 (format—unit)	FIELD_ACTIVITY (`int`，列舉) 使用者進行的活動類型。如要查看活動類型清單，請按這裡。

基礎代謝率 (BMR)

這個資料類型會擷取韓國境內使用者的 BMR。每個資料點代表使用者在休息一整天中會燃燒的卡路里依身高和體重進行分類只需設定結束時間。這個會做為讀取作業的時間戳記。

REST

名稱	`com.google.calories.bmr`
OAuth 權限範圍	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
欄位 (格式：units)	卡路里 (`float`—每天大卡) 使用者在休息中的一整天會燃燒的千焦耳 (根據身高和體重而定)。

Android

名稱	`com.google.calories.bmr`
資料類型物件	`TYPE_BASAL_METABOLIC_RATE`
欄位 (格式：units)	FIELD_CALORIES (`float`：每天大卡) 在休息狀態下，使用者一整天可能消耗的千焦耳數量 (根據年齡、體重和身高而定)。

卡路里燃燒量

這個資料類型會擷取使用者，包括靜息時燃燒的卡路里 (BMR)。每個資料點都代表時間間隔內的燃燒總卡量，因此開始時間和結束時間。

REST

名稱	`com.google.calories.expended`
OAuth 權限範圍	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
欄位 (格式：units)	卡路里 (`float`—大卡) 燃燒的大卡數。

Android

名稱	`com.google.calories.expended`
資料類型物件	`TYPE_CALORIES_EXPENDED`
Android 權限	`ACTIVITY_RECOGNITION`
欄位 (格式：units)	FIELD_CALORIES (`float`—大卡) 燃燒的大卡數。

單車踩踏頻率

如果使用者騎單車，這個資料類型可用來擷取騎腳踏車 每分鐘轉數 (RPM) 為單位。每個資料點都代表立即測量踩踏率，因此只需結束應設定時間。這會做為讀取作業的時間戳記。

REST

名稱	`com.google.cycling.pedaling.cadence`
OAuth 權限範圍	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
欄位 (格式：units)	rpm (`float` - rpm) 每分鐘單車刀轉數。

Android

名稱	`com.google.cycling.pedaling.cadence`
資料類型物件	`TYPE_CYCLING_PEDALING_CADENCE`
欄位 (格式：units)	FIELD_RPM (`float` - rpm) 每分鐘單車刀轉數。

騎單車累積

如果使用者騎單車，這個資料類型可用來擷取 一段時間內 crank 革命。每個資料點代表自開始計數以來的革命聲。

REST

名稱	`com.google.cycling.pedaling.cumulative`
OAuth 權限範圍	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
欄位 (格式：units)	revolutions (`int`，計數) 一段時間內的單車吊燈轉化次數。

Android

名稱	`com.google.cycling.pedaling.cumulative`
資料類型物件	`TYPE_CYCLING_PEDALING_CUMULATIVE`
欄位 (格式：units)	FIELD_REVOLUTIONS (`int`—計數) 一段時間內的單車吊燈轉化次數。

心肺強化分數

這個資料類型會擷取使用者獲得的心肺強化分數他們的活動。每個資料點代表計算出的心肺強化分數數量或間隔

使用者可以設定每日心肺強化分數目標並追蹤進度。心肺強化分數可以用以下方式計算：

獲得的心肺強化分數取決於活動強度。使用本指南說明如何計算及寫入心肺強化分數：

資料	1 HP (低強度活動)	2 HP (高強度活動)
心率	活動時間：1 分鐘，心率上限為 50%	以最大心率 >70% 進行活動 1 分鐘
MET 值	3-6 MET。例如划船或攀岩	> 6 MET。例如高強度間歇訓練、滑雪、排球或足球。
步行速度	每分鐘 100-130 步	每分鐘超過 130 步

REST

名稱	`com.google.heart_minutes`
OAuth 權限範圍	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
欄位 (格式：units)	強度 (`float`—心率) 系統會根據使用者的運動或活動強度獲得心肺強化分數。

Android

名稱	`com.google.heart_minutes`
資料類型物件	`TYPE_HEART_MINUTES`
欄位 (格式：units)	FIELD_INTENSITY (`float`—心點) 使用者進行的運動或活動的強度。一分鐘的低到中等身體活動 (例如，行走速度高於 2.5 mph，或騎行速度高於 10 mph) 可獲得 1 分心肺強化分數。延長 1 分鐘高強度活動可獲得 2 點心肺強化分數。

活動時間 (分鐘)

這個資料類型會擷取 Google Fit 計算的活動時間所獲得的收益。每個資料點都代表某時間間隔的活動分鐘數。開始和結束時間都必須設定。

使用者透過任何活動 (例如瑜珈、跳舞或園藝) 都能獲得「活動時間」和其他家庭家務如果他們散步，Google Fit 就會獲得 1 活動瞭解他們每分鐘在 60 秒內完成至少 30 步的情況。

REST

名稱	`com.google.active_minutes`
OAuth 權限範圍	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
欄位 (格式：units)	duration (`int` - 毫秒) 獲得的活動時間 (以毫秒為單位)。有效範圍：>=0

Android

名稱	`com.google.active_minutes`
資料類型物件	`TYPE_MOVE_MINUTES`
欄位 (格式：units)	FIELD_DURATION (`int` - 毫秒) 獲得的活動時間 (以毫秒為單位)。有效範圍：0 至 Long.MAX_VALUE

電源

這個資料類型會擷取使用者在執行某項活動時產生的功率，測量單位舉例來說，在固定式自行車每個資料點代表 100% 的即時測量結果產生的能量。

每個資料點都代表瞬間產生的功率測量結果，因此應設定結束時間。這會做為讀取作業的時間戳記。

REST

名稱	`com.google.power.sample`
OAuth 權限範圍	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
欄位 (格式：units)	W (`float`—W) 產生的功率，以瓦特為單位。

Android

名稱	`com.google.power.sample`
資料類型物件	`TYPE_POWER_SAMPLE`
欄位 (格式：units)	FIELD_WATTS (`float`—W) 產生的功率，以瓦特為單位。

步數計算頻率

這個資料類型會擷取步行頻率，以每分鐘步數測量。每項代表著每 100 個分鐘。

REST

名稱	`com.google.step_count.cadence`
OAuth 權限範圍	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
欄位 (格式：units)	rpm (`float`—步數/分鐘) 「步頻」是以每分鐘步數計算。

Android

名稱	`com.google.step_count.cadence`
資料類型物件	`TYPE_STEP_COUNT_CADENCE`
欄位 (格式：units)	FIELD_RPM (`float`—步數/分鐘) 「步頻」是以每分鐘步數計算。

步數差異

這個資料類型會擷取自上次讀取以來的步數。每項步驟只會回報一次，因此資料點不應有重疊的時間。每個資料點的開始時間應該代表已採取哪些步驟。

開始時間必須等於或大於結束時間上一個資料點的時間點將特定句點的所有值相加時間會計算該段期間的總步數。

REST

名稱 com.google.step_count.delta

OAuth 權限範圍

https://www.googleapis.com/auth/fitness.activity.read

https://www.googleapis.com/auth/fitness.activity.write

欄位 (格式：units)

steps (int，計數)

一段時間內的步數。

有效範圍：每秒 0 至 10 步

Android

名稱 com.google.step_count.delta

資料類型物件 TYPE_STEP_COUNT_DELTA

Android 權限 ACTIVITY_RECOGNITION

欄位 (格式：units)

TYPE_STEP_COUNT_DELTA (int，計數)

一段時間內的步數。

有效範圍：每秒 0 至 10 步

健身

每個資料點都代表一組連續的運動運動執行的每個動作資料點包含運動類型 ( 阻力運動或重量訓練範例)、重複次數運動、運動時間和阻力。

REST

名稱 com.google.activity.exercise

OAuth 權限範圍

https://www.googleapis.com/auth/fitness.activity.read

https://www.googleapis.com/auth/fitness.activity.write

欄位 (格式：units)

exercise (int，列舉)

代表不同運動的值，例如舉重運動、肌力訓練和心血管運動。

接受的值

back_extension
bridge.hip.single_leg
burpee
calf_press
calf_raise
calf_raise.seated
calf_raise.standing
chinup
clean
clean.hang
clean.hang_power
clean.jerk
clean.power
crunch
crunch.twisting
curl.bicep
deadlift
deadlift.rdl
deadlift.single_leg
deadlift.straight_leg
dip
dip.chest
dip.triceps
fly
good_morning
hip_extension
hip_raise
hip_thrust
jumping_jack
leg_curl
leg_extension
leg_press
leg_raise
lunge
lunge.rear
lunge.side
plank
plank.side
press.bench
press.bench.close_grip
press.bench.decline
press.bench.incline
press.jm
press.pike
press.shoulder
press.shoulder.arnold
press.shoulder.military
pulldown
pullover
pullup
pushup
pushup.close_grip
pushup.pike
raise.front
raise.lateral
raise.lateral.rear
row
row.high
row.upright
run.high_knee
russian_twist
shrug
situp
situp.twisting
squat
step_up
swing
thruster
triceps_extension
vups
wall_sit

repetitions (int，列舉)

運動重複次數。

resistance type (int—列舉)

運動期間使用的阻力類型。

接受的值

"intVal": 0 // The resistance type is unknown, unspecified, or can't be represented by a value.
"intVal": 1 // The user is using a barbell for resistance.
"intVal": 2 // The user is using a cable for resistance. If using 2 cables are used (one for each arm), include the resistance weight for one arm.
"intVal": 3 // The user is using dumbells for resistance.
"intVal": 4 // The user is using a kettlebell for resistance
"intVal": 5 // The user is performing the exercise in a machine.
"intVal": 6 // The user is using their own body weight for resistance.

resistance (float 至 kg)

運動 (或體重) 的阻力，以公斤為單位。

duration (int - 毫秒)

持續時間重要的運動持續時間。

Android

名稱 com.google.activity.exercise

欄位 (格式：units)

FIELD_EXERCISE (int—列舉)

代表不同運動的值，例如舉重運動、肌力訓練和心血管運動。

接受的值

ARNOLD_PRESS
BACK_EXTENSION
BENCH_PRESS
BICEP_CURL
BURPEE
CALF_PRESS
CALF_RAISE
CHEST_DIP
CHINUP
CLEAN
CLEAN_JERK
CLOSE_GRIP_BENCH_PRESS
CLOSE_GRIP_PUSHUP
CRUNCH
DEADLIFT
DECLINE_BENCH_PRESS
DIP
FLY
FRONT_RAISE
GOOD_MORNING
HANG_CLEAN
HANG_POWER_CLEAN
HIGH_KNEE_RUN
HIGH_ROW
HIP_EXTENSION
HIP_RAISE
HIP_THRUST
INCLINE_BENCH_PRESS
JM_PRESS
JUMPING_JACK
LATERAL_RAISE
LEG_CURL
LEG_EXTENSION
LEG_PRESS
LEG_RAISE
LUNGE
MILITARY_PRESS
PIKE_PRESS
PIKE_PUSHUP
PLANK
POWER_CLEAN
PULLDOWN
PULLOVER
PULLUP
PUSHUP
RDL_DEADLIFT
REAR_LATERAL_RAISE
REAR_LUNGE
ROW
RUSSIAN_TWIST
SEATED_CALF_RAISE
SHOULDER_PRESS
SHRUG
SIDE_LUNGE
SIDE_PLANK
SINGLE_LEG_DEADLIFT
SINGLE_LEG_HIP_BRIDGE
SITUP
SQUAT
STANDING_CALF_RAISE
STEP_UP
STRAIGHT_LEG_DEADLIFT
SWING
THRUSTER
TRICEPS_DIP
TRICEPS_EXTENSION
TWISTING_CRUNCH
TWISTING_SITUP
UPRIGHT_ROW
V_UPS
WALL_SIT

FIELD_REPETITIONS (int—數量)

運動重複次數。

FIELD_RESISTANCE_TYPE (int—列舉)

運動期間使用的阻力類型。

接受的值

RESISTANCE_TYPE_UNKNOWN // The resistance type is unknown, unspecified, or can't be represented by a value.
RESISTANCE_TYPE_BARBELL // The user is using a barbell for resistance.
RESISTANCE_TYPE_CABLE // The user is using a cable for resistance. If using 2 cables are used (one for each arm), include the resistance weight for one arm.
RESISTANCE_TYPE_DUMBBELL // The user is using dumbells for resistance.
RESISTANCE_TYPE_KETTLEBELL // The user is using a kettlebell for resistance
RESISTANCE_TYPE_MACHINE // The user is performing the exercise in a machine.
RESISTANCE_TYPE_BODY // The user is using their own body weight for resistance.

FIELD_RESISTANCE (float 至 kg)

運動 (或體重) 的阻力，以公斤為單位。

FIELD_DURATION (int - 毫秒)

持續時間重要的運動持續時間。