活动数据类型

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

Activity

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

如果用户在该时间段内执行了多个 activity，请为主 activity 类型创建一个会话，并针对不同的 activity 类型创建多个细分。 例如，如果用户在混合武术课程中进行一些跆拳道和拳击活动，就为综合格斗创建会话。然后，您可以将不同的 activity 类型细分为多个细分。

每个数据点都需要有开始时间和结束时间。数据点不需要连续或紧接在一起，它们之间可能会存在间隙。

注意：来自同一数据流的数据点的时间范围不应重叠！否则，来自重叠时间段的数据将被丢弃，这可能会导致预期值和显示的值之间存在差异。

REST

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

Android

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

基础代谢率 (BMR)

此数据类型用于捕获用户的 BMR，以千焦为单位。每个数据点表示用户全天休息时消耗的千焦耳数（根据其身高和体重）。只能设置结束时间。此值将用作读取操作的时间戳。

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

REST

Name	com.google.calories.bmr
OAuth 权限范围	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
字段（格式 - 单位）	卡路里（float - 千卡/天） 用户全天休息时消耗的千焦耳数量（基于其身高和体重）。

Android

Name	com.google.calories.bmr
数据类型对象	TYPE_BASAL_METABOLIC_RATE
字段（格式 - 单位）	FIELD_CALORIES（float - 千卡/天） 用户全天休息时消耗的千焦耳数，基于其年龄、体重和身高。

消耗卡路里数

此数据类型会捕获用户消耗的总卡路里数（以千焦为单位），包括静态消耗的卡路里 (BMR)。每个数据点都表示某个时间段内消耗的千焦耳总数，因此应同时设置开始时间和结束时间。

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

REST

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

Android

Name	com.google.calories.expended
数据类型对象	TYPE_CALORIES_EXPENDED
Android 权限	ACTIVITY_RECOGNITION
字段（格式 - 单位）	FIELD_CALORIES（float - kcal） 消耗卡路里数。

单车踩踏频率

如果用户开始骑车，这种数据类型可用于以每分钟曲柄转数 (RPM) 为单位记录踩踏速度。每个数据点都表示踩踏率的瞬时测量值，因此应仅设置结束时间。此值将用作读取操作的时间戳。

注意：在计算瞬时 RPM 之前，不同的数据源需要监控不同的曲柄转动时间。这应表示为数据源的一部分，而不是数据点。

REST

Name	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

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

自行车踏板累计

如果用户开始骑行，这种数据类型可以用于捕获一段时间内的曲柄转动次数。每个数据点都表示自起始时刻开始以来的旋转次数。

注意：每个数据点都会捕获自开始时间以来的总旋转次数。并不是革命的转折或变化。因此，可以通过用开始处的初始计数减去结束时间的最终计数来计算一段时间内的转数。

REST

Name	com.google.cycling.pedaling.cumulative
OAuth 权限范围	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
字段（格式 - 单位）	revolutions（int - count） 一段时间内的自行车曲柄转动次数。

Android

Name	com.google.cycling.pedaling.cumulative
数据类型对象	TYPE_CYCLING_PEDALING_CUMULATIVE
字段（格式 - 单位）	FIELD_REVOLUTIONS（int - 计数） 一段时间内的自行车曲柄转动次数。

心肺强化分数

此数据类型会捕获用户从其所有活动中获得的心肺强化分数。每个数据点表示一段时间内计算得出的心肺强化分数数量。

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

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

获得的心肺强化分数数量取决于活动的强度。本指南介绍了如何计算和写入心肺强化分数：

数据	1 HP（中低强度活动）	2 HP（高强度活动）
心率	最大心率 50% 时活动 1 分钟	活动 1 分钟，最大心率为 70%
MET 值	3-6 MET例如划船或攀岩	>6 MET. 例如 HIIT、滑雪、排球或足球。
步行速度	每分钟 100-130 步	每分钟 130 步 >

注意：必须同时设置开始时间和结束时间。这些时间戳需要向上或向下舍入到最接近的分钟数，因此秒数值应始终为 :00。

REST

Name	com.google.heart_minutes
OAuth 权限范围	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
字段（格式 - 单位）	强度（float - 心肺强化分数） 根据运动或用户进行的运动强度获得的心肺强化分数。

Android

Name	com.google.heart_minutes
数据类型对象	TYPE_HEART_MINUTES
字段（格式 - 单位）	FIELD_INTENSITY（float - 心肺强化分数） 用户进行的锻炼或活动的强度。进行 1 分钟的适度体育活动（如速度超过 2.5 英里/小时或 10 英里/小时）可获得 1 分心肺强化分数。1 分钟的剧烈运动可获得 2 分心肺强化分数。

活动时间

此数据类型会捕获 Google 健身从用户的所有活动中计算的运动时长（以分钟为单位）。每个数据点都表示某个时间间隔内的活动时间（以分钟为单位）。必须同时设置开始时间和结束时间。

用户可通过瑜伽、舞蹈、园艺等各种家务做任何活动来赚取活动时间。如果他们步行，那么 Google 健身每次在 60 秒内完成至少 30 步时，就会获得一个活动时间的分钟数。

注意：这些时间戳需要向上或向下舍入到最接近的分钟数，因此秒数值应始终为 :00。

REST

Name	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

Name	com.google.active_minutes
数据类型对象	TYPE_MOVE_MINUTES
字段（格式 - 单位）	FIELD_DURATION（int - 毫秒） 获得的活动时间（以毫秒为单位）。 有效范围：0—Long.MAX_VALUE

电源

此数据类型可捕获用户在执行活动时产生的电力（以瓦特为单位）。例如，在固定自行车上锻炼时使用电量计。每个数据点都代表一个瞬时测量的功率。

每个数据点都代表发电量的瞬时测量值，因此只能设置结束时间。此值将用作读取操作的时间戳。

REST

Name	com.google.power.sample
OAuth 权限范围	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
字段（格式 - 单位）	瓦特（float - 瓦特） 发电量（以瓦特为单位）。

Android

Name	com.google.power.sample
数据类型对象	TYPE_POWER_SAMPLE
字段（格式 - 单位）	FIELD_WATTS（float - 瓦特） 发电量（以瓦特为单位）。

步数计数频率

此数据类型捕获步行频率，以每分钟步数为单位。每个数据点都代表着每分钟的迈步频率。

REST

Name	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

Name	com.google.step_count.cadence
数据类型对象	TYPE_STEP_COUNT_CADENCE
字段（格式 - 单位）	FIELD_RPM（float - 步/分钟） 以每分钟步数为单位衡量步调。

步数增量

此数据类型会捕获自上次读取以来行走的步数。每个步骤仅报告一次，因此数据点的时间不应重叠。每个数据点的开始时间应表示行走的时间间隔的开始时间。

开始时间必须等于或大于上一个数据点的结束时间。将一段时间内的所有值相加，计算出该期间的总步数。

REST

Name	com.google.step_count.delta
OAuth 权限范围	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
字段（格式 - 单位）	steps（int - count） 一段时间内行走步数。 有效范围：0 - 10 步/秒

Android

Name	com.google.step_count.delta
数据类型对象	TYPE_STEP_COUNT_DELTA
Android 权限	ACTIVITY_RECOGNITION
字段（格式 - 单位）	TYPE_STEP_COUNT_DELTA（int - count） 一段时间内行走步数。 有效范围：0 - 10 步/秒

健身

每个数据点代表用户执行的一套连续的锻炼活动。数据点包含锻炼类型（例如阻力锻炼或体重训练）、锻炼重复次数、锻炼时长和阻力的字段。

REST

Name	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—kg) 锻炼（或重）的阻力，以千克为单位。 duration（int - 毫秒） 锻炼时长（对于锻炼时长至关重要）。

Android

Name

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 - 毫秒） 锻炼时长（对于锻炼时长至关重要）。