活動資料類型

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

活動

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

如果使用者在這段期間內進行了多項活動，請為主要活動類型建立工作階段，並為不同的活動類型建立多個區隔。舉例來說，如果他們在混合武術課程期間多做拳擊和拳擊，則建立了混合武術課程。然後，您可以將不同的活動 細分為不同的區隔

每個資料點都需要開始時間和結束時間。資料點不需要回溯或連續，兩者之間可能存在落差。

注意： 同一串流中資料點的時間範圍不得重疊！如為這樣，系統就會捨棄重疊期間的資料，這可能會導致預期與顯示的值之間出現差異。

REST

名稱	com.google.activity.segment
OAuth 權限範圍	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
欄位 (format—units)	活動類型 (int：列舉) 使用者進行的活動類型。詳情請參閱活動類型清單。

Android

名稱	com.google.activity.segment
資料類型物件	TYPE_ACTIVITY_SEGMENT
Android 權限	ACTIVITY_RECOGNITION
欄位 (format—unit)	FIELD_ACTIVITY (int—列舉) 使用者進行的活動類型。詳情請參閱活動類型清單。

基礎代謝率 (BMR)

這個資料類型會擷取每月使用者的 BMR。每個資料點代表使用者全天休息時可燃燒的卡路里數量 (取決於使用者的身高和體重)。只需設定結束時間。這會做為讀取的時間戳記。

注意： Google Fit 會使用 BMR 計算卡路里燃燒量。不會直接在應用程式中顯示。

REST

名稱	com.google.calories.bmr
OAuth 權限範圍	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
欄位 (format—units)	calories (每日 float—大卡) 使用者在整天休息時，根據身高和體重所燃燒的公斤數。

Android

名稱	com.google.calories.bmr
資料類型物件	TYPE_BASAL_METABOLIC_RATE
欄位 (format—units)	FIELD_CALORIES (每天 float—大卡) 使用者在整日休息時，根據年齡、體重和身高而燃燒的公斤數。

卡路里燃燒量

這個資料類型會擷取使用者燃燒的總卡路里 (千焦耳)，包括靜止時燃燒的卡路里 (BMR)。每個資料點代表在時間間隔內燃燒的總公斤數，因此必須同時設定開始和結束時間。

注意： 寫入卡路里資料時，請一併附上靜止的卡路里燃燒量 (使用者的 BMR)。

REST

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

Android

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

單車踩踏頻率

如果使用者騎自行車，這個資料類型可用來擷取騎行率，單位為「每分鐘轉速 (RPM)」。每個資料點代表一種即時測量步速的測量指標，因此只能設定結束時間。這會做為讀取的時間戳記。

注意： 計算即時 RPM 之前，不同的資料來源需要監控惡作劇轉場時間的不同時間。這應在資料來源 (而非資料點) 中表示。

REST

名稱	com.google.cycling.pedaling.cadence
OAuth 權限範圍	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
欄位 (format—units)	rpm (float—rpm) 單車搖擺每分鐘轉動次數。

Android

名稱	com.google.cycling.pedaling.cadence
資料類型物件	TYPE_CYCLING_PEDALING_CADENCE
欄位 (format—units)	FIELD_RPM (float—rpm) 單車搖擺每分鐘轉動次數。

自行車踩踏次數累計

如果使用者騎自行車，這個資料類型可用於擷取一段時間內的惡作劇革命數。每個資料點都代表自開始時間開始以來的革命次數。

注意： 每個資料點會擷取自開始時間以來的革命總數。這不是革命中的差異或革命變化。因此，只要在開始時間的初始計數中，減去結束時間的最終計數，即可計算時間間隔內的轉乘次數。

REST

名稱	com.google.cycling.pedaling.cumulative
OAuth 權限範圍	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
欄位 (format—units)	revolutions (int—計數) 在特定時間範圍內，單車搖擺的革命次數。

Android

名稱	com.google.cycling.pedaling.cumulative
資料類型物件	TYPE_CYCLING_PEDALING_CUMULATIVE
欄位 (format—units)	FIELD_REVOLUTIONS (int—計數) 在特定時間範圍內，單車搖擺的革命次數。

心肺強化分數

這個資料類型會擷取使用者從所有活動獲得的心肺強化分數數量。每個資料點都代表在特定時間間隔計算出的心肺強化分數。

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

• 心率
• 任務 (MET) 值的代謝當量
• 步行速度

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

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

注意： 您必須設定開始和結束時間。這些時間戳記必須四捨五入至最接近的分鐘數，因此秒數值一律應為 :00。

REST

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

Android

名稱	com.google.heart_minutes
資料類型物件	TYPE_HEART_MINUTES
欄位 (format—units)	FIELD_INTENSITY (float：心肺強化分數) 使用者進行的運動或活動強度。從事中等體能活動的頻率 (例如步行超過 2.5 英里，或騎單車速度超過 10 英里) 即可獲得 1 分心肺強化分數。經過一分鐘的高強度活動可以獲得 2 分心肺強化分數。

活動時間 (分鐘)

這個資料類型會擷取 Google Fit 從所有活動中計算的使用者活動分鐘數。每個資料點都代表特定時間間隔的「活動時間」(分鐘) 累計次數。同時必須設定開始和結束時間。

使用者可透過任何活動 (例如瑜珈、舞蹈、園藝和其他家庭家務) 賺取「活動時間」(分鐘)。如果他們出門散步，Google Fit 會在 60 秒內至少完成 30 步，並給予一部「活動分鐘數」的獎勵。

注意： 這些時間戳記必須四捨五入至最接近的分鐘數，因此秒數值應一律為 :00。

REST

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

Android

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

功率

這個資料類型會擷取使用者在執行活動時產生的功率，以瓦特為單位。例如，在騎腳踏車上運動時使用電源計。每個資料點都代表產生的功率的即時測量結果。

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

REST

名稱	com.google.power.sample
OAuth 權限範圍	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
欄位 (format—units)	W (float—W) 發電，以瓦特為單位。

Android

名稱	com.google.power.sample
資料類型物件	TYPE_POWER_SAMPLE
欄位 (format—units)	FIELD_WATTS (float—瓦特) 發電，以瓦特為單位。

步數

這個資料類型可以擷取步行頻率，測量單位為每分鐘步數。每個資料點都代表每分鐘步數的即時測量。

REST

名稱	com.google.step_count.cadence
OAuth 權限範圍	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
欄位 (format—units)	rpm (float：步數/分鐘) 「步速」的測量單位為每分鐘步數。

Android

名稱	com.google.step_count.cadence
資料類型物件	TYPE_STEP_COUNT_CADENCE
欄位 (format—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
欄位 (format—units)	steps (int：計數) 一段時間內的步數。 有效範圍：每秒 0 至 10 步

Android

名稱	com.google.step_count.delta
資料類型物件	TYPE_STEP_COUNT_DELTA
Android 權限	ACTIVITY_RECOGNITION
欄位 (format—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
欄位 (format—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

欄位 (format—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—公斤) 運動 (或體重) 的阻力，以公斤為單位。 FIELD_DURATION (int—毫秒) 持續時間至關重要的運動期間。