活动数据类型

这些数据类型可用于捕获活动、锻炼和与锻炼相关的指标。

活动

此数据类型可用于捕获用户执行的任何活动。这可以是跑步或各种运动等常见健身活动，也可以是冥想、园艺和睡眠等活动。

如果用户在该时间段内进行了多种活动，请为主要活动类型创建一个会话，并为不同的活动类型创建多个细分。例如，如果用户在综合格斗课程中练习了少量的踢拳和拳击，请为综合格斗创建会话。然后，您可以将不同的活动类型细分为不同的细分。

每个数据点都需要一个开始时间和结束时间。数据点不必紧挨着或直接相连，中间可以有间隔。

注意： 来自同一数据流的数据点的时间范围不应重叠！如果存在重叠，系统会舍弃重叠期的数据，这可能会导致预期值与显示值之间出现差异。

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 - 枚举） 用户当时正在进行的活动类型。点击此处查看活动类型列表。

基础代谢率 (BMR)

此数据类型用于捕获用户的 BMR（以千卡为单位）。每个数据点表示用户在整天静息状态下会消耗的千卡数，该数值基于用户的身高和体重计算得出。应仅设置结束时间。这将用作阅读的时间戳。

注意： 在 Google 健身中，基础代谢率用于计算消耗的卡路里。不会直接显示在应用中。

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 - 每天千卡数） 用户在整天静息状态下消耗的千卡数，根据其年龄、体重和身高计算得出。

消耗卡路里数

此数据类型可捕获用户消耗的总卡路里数（以千卡为单位），包括休息时消耗的卡路里数（基础代谢率）。每个数据点表示某个时间间隔内消耗的总千卡数，因此应同时设置开始时间和结束时间。

注意： 写入消耗卡路里数时，请包含静息时消耗的卡路里（用户的 BMR）。

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 - 千卡） 消耗的千卡数。

单车踩踏频率

如果用户骑自行车，可以使用此数据类型来捕获其踩踏频率，以每分钟曲柄转数 (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
字段（格式 - 单位）	rpm（float—rpm） 每分钟的自行车曲柄转数。

Android

名称	com.google.cycling.pedaling.cadence
数据类型对象	TYPE_CYCLING_PEDALING_CADENCE
字段（格式 - 单位）	FIELD_RPM（float - 转/分钟） 每分钟的自行车曲柄转数。

骑车踩踏累计次数

如果用户去骑自行车，可以使用此数据类型来捕获一段时间内的曲柄旋转次数。每个数据点表示自开始时间以来旋转的圈数。

注意： 每个数据点都会捕获自开始时间以来的总圈数。它不是转数的增量或变化。因此，可以通过从结束时间的最终计数中减去开始时间的初始计数来计算时间间隔内的转数。

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 - 次数） 在一段时间内的自行车曲柄旋转次数。

心肺强化分数

此数据类型会记录用户通过所有活动获得的心肺强化分数。每个数据点表示在某个时间间隔内计算出的心肺强化分数。

用户可以设置每日心肺强化分数目标并跟踪进度。心肺强化分数可通过以下方式计算：

• 心率
• 代谢当量 (MET) 值
• 步行速度

获得的心肺强化分数取决于活动的强度。请参阅本指南，了解如何计算和获得心肺强化分数：

数据	1 HP（低中强度活动）	2 个 HP（高强度活动）
心率	以高于最大心率 50% 的心率进行活动 1 分钟	以高于 70% 最大心率的强度进行活动 1 分钟
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
字段（格式 - 单位）	强度（float - 心肺强化分数） 根据用户所做锻炼或活动的强度获得的心肺强化分数。

Android

名称	com.google.heart_minutes
数据类型对象	TYPE_HEART_MINUTES
字段（格式 - 单位）	FIELD_INTENSITY（float - 心脏点） 用户所做锻炼或活动的强度。进行 1 分钟的低强度到中等强度的身体活动（例如以超过 2.5 英里的时速快走，或以超过 10 英里的时速骑自行车）可获得 1 分心肺强化分数。进行 1 分钟更高强度的活动可获得 2 分心肺强化分数。

活动时间

此数据类型会记录 Google 健身根据用户的所有活动计算出的活动时间。每个数据点都表示相应时间间隔内计算出的运动分钟数。必须同时设置开始时间和结束时间。

用户可以通过瑜伽、跳舞、园艺和其他家务活动来赚取活动时间。如果用户去散步，Google Fit 会在用户 60 秒内至少走 30 步时奖励 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 - 瓦特） 发电量（以瓦特为单位）。

步数频次

此数据类型用于捕获步行步频，以每分钟步数为单位。每个数据点都表示每分钟步数的瞬时迈步频率测量值。

REST

名称	com.google.step_count.cadence
OAuth 权限范围	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
字段（格式 - 单位）	每分钟转数（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 - 步数） 在一段时间内所走的步数。 有效范围：每秒 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 - 枚举） 某项练习的重复次数。 阻力类型（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 - 枚举） 表示不同锻炼的值，例如举重锻炼、力量训练和心血管锻炼。 已接受的值 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 - 毫秒） 时长很重要的锻炼的时长。