活动数据类型

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

Activity

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

如果用户在该时间段内进行了多项活动，请为主活动类型创建一个会话，并针对不同的活动类型创建多个细分。例如，如果他们在综合格斗课程期间进行了一些踢拳和拳击，可以创建一个综合格斗课程。然后，您可以将不同的活动类型细分为不同的细分。

每个数据点都需要有开始时间和结束时间。数据点无需连续或直接相邻，之间可能会存在差异。

注意 ：同一数据流中数据点的时间范围不应重叠！否则，重叠时间段的数据将被丢弃，从而导致预期值和显示值之间出现差异。

REST

名称	com.google.activity.segment
OAuth 权限范围	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
字段（格式 - 单位）	activity 类型（int - 枚举） 用户所进行活动的类型。请在此处查看活动类型列表。

Android

名称	com.google.activity.segment
数据类型对象	TYPE_ACTIVITY_SEGMENT
Android 权限	ACTIVITY_RECOGNITION
字段（格式 - 单位）	FIELD_ACTIVITY （int - 枚举） 用户所进行活动的类型。请在此处查看活动类型列表。

基础代谢率 (BMR)

此数据类型捕获用户的 BMR，以千卡路里为单位。每个数据点代表用户全天休息时消耗的千卡路里数，基于其身高和体重。只应设置结束时间。这将用作读取操作的时间戳。

注意 ：在 Google 健身中，BMR 用于计算消耗的卡路里。并不会直接在应用中显示。

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)。每个数据点代表一段时间内消耗的总千卡路里，因此开始时间和结束时间都应设置完毕。

注意 ：写入卡路里数据时，请添加在休息时消耗的卡路里数（用户的 BMR）。

REST

名称	com.google.calories.expended
OAuth 权限范围	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
字段（格式 - 单位）	calories (float—kcal) 消耗千卡路里数。

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

心肺强化分数

此数据类型会捕获用户通过所有活动获得的心肺强化分数。每个数据点代表针对相应时间间隔计算出的心肺强化分数。

用户可以设置每日心肺强化分数目标并追踪他们的进度。心肺强化分数的计算方式如下：

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

获得的心肺强化分数取决于运动的强度。可以按照本指南计算和写入心肺强化分数：

数据	1 马力（低中强度活动）	2 个 HP（高强度活动）
心率	以高于 50% 的最大心率进行活动 1 分钟	以 >70% 最大心率进行活动 1 分钟
MET 值	3-6 MET。例如划船或攀岩	MET 高于 6。例如：高强度间歇训练 (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
字段（格式 - 单位）	intenity（float - 心肺强化分数） 根据用户锻炼或活动的强度获得心肺强化分数。

Android

名称	com.google.heart_minutes
数据类型对象	TYPE_HEART_MINUTES
字段（格式 - 单位）	FIELD_INTENSITY（float - 心肺强化分数） 用户运动或活动的强度。进行 1 分钟轻度到中等体育活动（例如步行速度超过 2.5 英里/小时，或骑车速度超过 10 英里/小时）可获得 1 分心肺强化分数。进行 1 分钟更剧烈的运动可获得 2 分心肺强化分数。

活动时间

此数据类型会捕获 Google 健身计算的用户从所有活动中获得的活动分钟数。每个数据点都代表相应时间间隔内的“活动时间”派生分钟数。必须同时设置开始时间和结束时间。

用户可通过任何活动（例如瑜伽、舞蹈、园艺和其他家务）获得活动时间。如果他们进行散步，每当他们在 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 - 瓦特） 发电的功率（以瓦特为单位）。

步数统计频率

此数据类型可捕获步行频率，以每分钟步数为单位。每个数据点都代表对节奏的瞬时测量（以每分钟步数为单位）。

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
字段（格式 - 单位）	steps（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 - 枚举） 一项运动的重复次数。 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. 电阻（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 - 千克） 运动（或体重）的阻力，以千克为单位。 FIELD_DURATION（int - 毫秒） 对时间很重要的运动的持续时间。