活動資料類型

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

活動

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

如果使用者在該時間範圍內進行多項活動，請為主要活動類型建立工作階段，並為不同活動類型建立多個區隔。舉例來說，如果使用者在綜合格鬥課程中進行了少許拳擊和拳擊運動，請為綜合格鬥建立活動。然後將不同類型的活動細分成區隔。

每個資料點都需要開始時間和結束時間。資料點不一定要緊接在彼此之後，中間可以有間隔。

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

REST

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

Android

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

基礎代謝率 (BMR)

這類資料會以千卡為單位，擷取使用者的基礎代謝率。每個資料點代表使用者整天休息時會消耗的千卡路里數，計算依據為身高和體重。只要設定結束時間即可。這會做為讀取時間戳記。

注意： Google Fit 會使用基礎代謝率計算消耗的卡路里。不會直接顯示在應用程式中。

REST

名稱	com.google.calories.bmr
OAuth 權限範圍	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
欄位 (格式：單位)	卡路里 (每天 float 大卡) 根據使用者的身高和體重，計算使用者整天休息時會燃燒的千卡路里數。

Android

名稱	com.google.calories.bmr
資料類型物件	TYPE_BASAL_METABOLIC_RATE
欄位 (格式：單位)	FIELD_CALORIES (float 大卡/天) 根據使用者的年齡、體重和身高，計算使用者整天休息時會燃燒的千卡路里數。

卡路里燃燒量

這項資料類型會擷取使用者消耗的總卡路里 (以千卡為單位)，包括休息時消耗的卡路里 (基礎代謝率)。每個資料點代表一段時間內燃燒的總熱量 (大卡)，因此請務必設定開始和結束時間。

注意： 寫入卡路里資料時，請一併納入休息時燃燒的卡路里 (使用者的基礎代謝率)。

REST

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

Android

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

單車踩踏頻率

如果使用者騎自行車，這項資料類型可用於擷取踩踏頻率，單位為每分鐘轉數 (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
欄位 (格式：單位)	每分鐘轉速 (float 每分鐘轉速) 每分鐘的自行車曲柄轉數。

Android

名稱	com.google.cycling.pedaling.cadence
資料類型物件	TYPE_CYCLING_PEDALING_CADENCE
欄位 (格式：單位)	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
欄位 (格式：單位)	轉數 (int - 數量) 一段時間範圍內的自行車曲柄轉數。

Android

名稱	com.google.cycling.pedaling.cumulative
資料類型物件	TYPE_CYCLING_PEDALING_CUMULATIVE
欄位 (格式：單位)	FIELD_REVOLUTIONS (int—count) 一段時間範圍內的自行車曲柄轉數。

心肺強化分數

這項資料類型會擷取使用者透過所有活動獲得的心肺活力點數。每個資料點代表在一段時間內計算的心肺活力點數。

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

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

心肺活動分數的計算方式取決於活動強度。請按照本指南計算及寫入心肺強化分數：

資料	1 HP (低中強度活動)	2 個 HP (高強度活動)
心率	從事活動時，心率超過最大心率的 50%	從事活動時，心率超過最大心率的 70%
MET 值	3-6 MET。例如划船或攀岩，	>6 MET。例如高強度間歇訓練、滑雪、排球或足球。
步行速度	每分鐘 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
欄位 (格式：單位)	強度 (float 心肺強化分數) 根據使用者運動或活動的強度賺取的心肺活力點數。

Android

名稱	com.google.heart_minutes
資料類型物件	TYPE_HEART_MINUTES
欄位 (格式：單位)	FIELD_INTENSITY (float—心臟點數) 使用者進行運動或活動的強度。從事和緩至中等強度的體能活動 (例如快走，時速超過 4 公里；或騎自行車，時速超過 16 公里) 時，每分鐘可獲得 1 分心肺強化分數。從事強度更高的活動時，每分鐘可獲得 2 分心肺強化分數。

活動時間 (分鐘)

這項資料類型會擷取 Google Fit 根據使用者所有活動計算出的活動分鐘數。每個資料點代表一段時間間隔內得出的活動分鐘數。必須設定開始時間和結束時間。

使用者可以透過任何活動賺取活動時間 (分鐘)，例如瑜伽、跳舞、園藝和其他家事。如果他們去散步，只要在 60 秒內至少走 30 步，Google 健身就會授予 1 分鐘的活動分鐘數。

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

REST

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

Android

名稱	com.google.active_minutes
資料類型物件	TYPE_MOVE_MINUTES
欄位 (格式：單位)	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
欄位 (格式：單位)	瓦特 (float—瓦特) 發電量 (以瓦為單位)。

Android

名稱	com.google.power.sample
資料類型物件	TYPE_POWER_SAMPLE
欄位 (格式：單位)	FIELD_WATTS (float—watts) 發電量 (以瓦為單位)。

步頻

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

REST

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

Android

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

Android

名稱	com.google.step_count.delta
資料類型物件	TYPE_STEP_COUNT_DELTA
Android 權限	ACTIVITY_RECOGNITION
欄位 (格式：單位)	TYPE_STEP_COUNT_DELTA (int—count) 一段時間內的步數。 有效範圍：每秒 0 到 10 步

健身

每個資料點代表使用者進行的一組連續運動。資料點包含運動類型 (例如阻力訓練或重量訓練)、運動重複次數、運動時間長度和阻力等欄位。

REST

名稱	com.google.activity.exercise
OAuth 權限範圍	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
欄位 (格式：單位)	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—enum) 運動的重複次數。 抗性類型 (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. 阻力 (float—公斤) 運動的阻力 (或重量)，單位為公斤。 duration (int—毫秒) 運動時間長度，單位為秒。

Android

名稱

com.google.activity.exercise

欄位 (格式：單位)

FIELD_EXERCISE (int—enum) 代表不同運動的值，例如舉重運動、肌力訓練運動和心血管運動。 接受的值 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—count) 運動的重複次數。 FIELD_RESISTANCE_TYPE (int—enum) 運動時使用的阻力類型。 接受的值 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—毫秒) 運動時間長度，單位為秒。