Tipos de datos de Health Connect

Health Connect almacena y estructura datos de salud y actividad física, así como datos de registros médicos. Primero, es importante comprender qué tipos de datos y permisos ofrece Health Connect para que puedas planificar los requisitos de tu app.

Después del desarrollo, cuando te prepares para publicar tu app en Play Store, debes declarar el uso de datos de tu app, así como el acceso a los tipos de datos de Health Connect que usa tu app. De lo contrario, es posible que se les muestre a los usuarios un mensaje de error en el que tu app no puede acceder a los tipos de datos de Health Connect porque requieren una aprobación especial.

Consulta Cómo completar la declaración de aplicaciones de salud en Play Console para obtener más información.

Categorías de tipos de datos

Health Connect admite tipos de datos que se usan en la mayoría de las apps de salud y fitness para proporcionar la mayor variedad posible. El objetivo de Health Connect es ofrecer una vista integral y el almacenamiento de datos de salud y actividad física. Estos tipos de datos se dividen en las siguientes categorías:

Tabla: Categorías de tipos de datos de Health Connect
Categoría Descripción
directions_run Actividad Captura cualquier actividad que realice el usuario. Puede incluir actividades de salud y estado físico, como correr y nadar.
Enderezar Medición corporal Captura datos comunes relacionados con el cuerpo, como el peso y la tasa metabólica basal de un usuario.
fértil Seguimiento del ciclo Registra los ciclos menstruales y los datos relacionados, como el resultado binario de una prueba de ovulación.
comestibles Nutrition Captura los tipos de datos de hidratación y nutrición. El primero representa cuánta agua consume un usuario en una sola toma. El último incluye campos opcionales, como calorías, azúcar y magnesio.
sleep_auto Sueño Captura los datos en intervalos relacionados con la duración y el tipo de sueño de un usuario.
vital_signs Signos vitales Registra información esencial sobre la salud general del usuario. Incluye datos como la temperatura corporal, la glucemia, la presión arterial y la saturación de oxígeno en sangre.
mindfulness Bienestar Captura datos relacionados con la salud mental y el bienestar de un usuario.

Campos de tipo de datos

La tabla de tipos de datos de Health Connect incluye varias columnas de campos para ayudarte a comprender la estructura y los requisitos de cada tipo de datos. Estas columnas son las siguientes:

Tabla: Descripciones de los campos de tipo de datos
Campo Descripción
programar Tipo de registro Indica si los datos se registran en un instante o durante un intervalo. Los valores posibles son: Interval, Instantaneous y Series.
Enderezar Unidad Unidad de medida del tipo de datos (por ejemplo, calorías, metros, recuento)
estrella Campos obligatorios Estos son los campos esenciales que se deben incluir cuando se escriben datos para este tipo de datos, lo que ayuda a mantener la integridad y la utilidad de los datos.

Tipos de datos de salud y estado físico

Antes de solicitar permisos, tu app debe declararlos en el manifiesto. Consulta la sección Cómo declarar permisos de la guía de inicio rápido para obtener más información.

Para leer datos mientras tu app está en segundo plano o para leer datos históricos, se debe declarar un conjunto adicional de permisos de lectura por separado de los permisos de tipo de datos:

Tabla: Permisos de lectura adicionales para los tipos de datos de Health Connect
Permiso de lectura adicional Declaración de permisos
Lee los datos en segundo plano
  Guía de ejemplo de lectura en segundo plano 		android.permission.health.READ_HEALTH_DATA_IN_BACKGROUND
Lee los datos históricos
  Guía para leer datos anteriores a 30 días 		android.permission.health.READ_HEALTH_DATA_HISTORY

1. Selecciona una versión de Jetpack

Las declaraciones de permisos difieren entre las versiones de Jetpack, así que asegúrate de seleccionar el rango de versiones de Jetpack que usa tu app.

2. Cómo filtrar la tabla de tipos de datos

En la siguiente tabla, se incluye la lista completa de tipos de datos, cada uno con su categoría, marcas y guías de funciones, y declaraciones de permisos.

Tabla: Tipos de datos de Health Connect
Tipo de datos
  Guías de funciones		 Categoría Tipo de registro
Declaraciones de permisos
Marca de función
Calorías activas quemadas

  • Tipo de registro: Intervalo
  • Unidad: Energía

  • Campos obligatorios

    endTime
    energy
    metadata
    startTime
Actividad ActiveCaloriesBurnedRecord

android.permission.health.READ_ACTIVE_CALORIES_BURNED
android.permission.health.WRITE_ACTIVE_CALORIES_BURNED

Tipos de datos agregados

ACTIVE_CALORIES_TOTAL
Intensidad de la actividad

  • Tipo de registro: Intervalo

  • Campos obligatorios

    activityIntensityType
    endTime
    metadata
    startTime
Actividad ActivityIntensityRecord

android.permission.health.READ_ACTIVITY_INTENSITY
android.permission.health.WRITE_ACTIVITY_INTENSITY

FEATURE_ACTIVITY_INTENSITY

Tipos de datos agregados

DURATION_TOTAL
INTENSITY_MINUTES_TOTAL
MODERATE_DURATION_TOTAL
VIGOROUS_DURATION_TOTAL
Temperatura corporal basal

  • Tipo de registro: Instantáneo
  • Unidad: Temperatura

  • Campos obligatorios

    temperature
    measurementLocation
    metadata
    time
Seguimiento del ciclo BasalBodyTemperatureRecord

android.permission.health.READ_BASAL_BODY_TEMPERATURE
android.permission.health.WRITE_BASAL_BODY_TEMPERATURE

Tasa metabólica basal

  • Tipo de registro: Instantáneo
  • Unidad: Potencia

  • Campos obligatorios

    basalMetabolicRate
    metadata
    time
Medidas corporales BasalMetabolicRateRecord

android.permission.health.READ_BASAL_METABOLIC_RATE
android.permission.health.WRITE_BASAL_METABOLIC_RATE

Tipos de datos agregados

BASAL_CALORIES_TOTAL
Glucemia

  • Tipo de registro: Instantáneo

  • Campos obligatorios

    level
    specimenSource
    mealType
    relationToMeal
    metadata
    time
Vitals BloodGlucoseRecord

android.permission.health.READ_BLOOD_GLUCOSE
android.permission.health.WRITE_BLOOD_GLUCOSE

Presión arterial

  • Tipo de registro: Instantáneo
  • Unidad: Presión

  • Campos obligatorios

    systolic
    diastolic
    bodyPosition
    measurementLocation
    metadata
    time
Vitals BloodPressureRecord

android.permission.health.READ_BLOOD_PRESSURE
android.permission.health.WRITE_BLOOD_PRESSURE

Tipos de datos agregados

DIASTOLIC_AVG
DIASTOLIC_MAX
DIASTOLIC_MIN
SYSTOLIC_AVG
SYSTOLIC_MAX
SYSTOLIC_MIN
Grasa corporal

  • Tipo de registro: Instantáneo

  • Campos obligatorios

    percentage
    metadata
    time
Medidas corporales BodyFatRecord

android.permission.health.READ_BODY_FAT
android.permission.health.WRITE_BODY_FAT

Temperatura corporal

  • Tipo de registro: Instantáneo
  • Unidad: Temperatura

  • Campos obligatorios

    temperature
    measurementLocation
    metadata
    time
Vitals BodyTemperatureRecord

android.permission.health.READ_BODY_TEMPERATURE
android.permission.health.WRITE_BODY_TEMPERATURE

Masa de agua corporal

  • Tipo de registro: Instantáneo
  • Unidad: Masa

  • Campos obligatorios

    mass
    metadata
    time
Medidas corporales BodyWaterMassRecord

android.permission.health.READ_BODY_WATER_MASS
android.permission.health.WRITE_BODY_WATER_MASS

Masa ósea

  • Tipo de registro: Instantáneo
  • Unidad: Masa

  • Campos obligatorios

    mass
    metadata
    time
Medidas corporales BoneMassRecord

android.permission.health.READ_BONE_MASS
android.permission.health.WRITE_BONE_MASS

Moco cervical

  • Tipo de registro: Instantáneo

  • Campos obligatorios

    appearance
    sensation
    metadata
    time
Seguimiento del ciclo CervicalMucusRecord

android.permission.health.READ_CERVICAL_MUCUS
android.permission.health.WRITE_CERVICAL_MUCUS

Cadencia de pedaleo en ciclismo

  • Tipo de registro: Serie

  • Campos obligatorios

    samples
    endTime
    metadata
    samples
    startTime
Actividad CyclingPedalingCadenceRecord

android.permission.health.READ_EXERCISE
android.permission.health.WRITE_EXERCISE

Tipos de datos agregados

RPM_AVG
RPM_MAX
RPM_MIN
Distancia

  • Tipo de registro: Intervalo
  • Unidad: Longitud

  • Campos obligatorios

    distance
    endTime
    metadata
    startTime
Actividad DistanceRecord

android.permission.health.READ_DISTANCE
android.permission.health.WRITE_DISTANCE

Tipos de datos agregados

DISTANCE_TOTAL
Desnivel acumulado

  • Tipo de registro: Intervalo
  • Unidad: Longitud

  • Campos obligatorios

    elevation
    endTime
    metadata
    startTime
Actividad ElevationGainedRecord

android.permission.health.READ_ELEVATION_GAINED
android.permission.health.WRITE_ELEVATION_GAINED

Tipos de datos agregados

ELEVATION_GAINED_TOTAL
Ejercicio

  Guía para agregar rutas de ejercicio
  • Tipo de registro: Intervalo

  • Campos obligatorios

    exerciseType
    endTime
    laps
    metadata
    segments
    startTime
Actividad ExerciseSessionRecord

android.permission.health.READ_EXERCISE
android.permission.health.READ_EXERCISE_ROUTE
android.permission.health.WRITE_EXERCISE
android.permission.health.WRITE_EXERCISE_ROUTE

Tipos de ejercicio

Ver todos los tipos de ejercicio
EXERCISE_TYPE_UNKNOWN
EXERCISE_TYPE_BADMINTON
EXERCISE_TYPE_BASEBALL
EXERCISE_TYPE_BASKETBALL
EXERCISE_TYPE_BIKING
EXERCISE_TYPE_BIKING_STATIONARY
EXERCISE_TYPE_BOOT_CAMP
EXERCISE_TYPE_BOXING
EXERCISE_TYPE_CALISTHENICS
EXERCISE_TYPE_CRICKET
EXERCISE_TYPE_DANCING
EXERCISE_TYPE_ELLIPTICAL
EXERCISE_TYPE_EXERCISE_CLASS
EXERCISE_TYPE_FENCING
EXERCISE_TYPE_FOOTBALL_AMERICAN
EXERCISE_TYPE_FOOTBALL_AUSTRALIAN
EXERCISE_TYPE_FRISBEE_DISC
EXERCISE_TYPE_GOLF
EXERCISE_TYPE_GUIDED_BREATHING
EXERCISE_TYPE_GYMNASTICS
EXERCISE_TYPE_HANDBALL
EXERCISE_TYPE_HIGH_INTENSITY_INTERVAL_TRAINING
EXERCISE_TYPE_HIKING
EXERCISE_TYPE_ICE_HOCKEY
EXERCISE_TYPE_ICE_SKATING
EXERCISE_TYPE_MARTIAL_ARTS
EXERCISE_TYPE_PADDLING
EXERCISE_TYPE_PARAGLIDING
EXERCISE_TYPE_PILATES
EXERCISE_TYPE_RACQUETBALL
EXERCISE_TYPE_ROCK_CLIMBING
EXERCISE_TYPE_ROLLER_HOCKEY
EXERCISE_TYPE_ROWING
EXERCISE_TYPE_ROWING_MACHINE
EXERCISE_TYPE_RUGBY
EXERCISE_TYPE_RUNNING
EXERCISE_TYPE_RUNNING_TREADMILL
EXERCISE_TYPE_SAILING
EXERCISE_TYPE_SCUBA_DIVING
EXERCISE_TYPE_SKATING
EXERCISE_TYPE_SKIING
EXERCISE_TYPE_SNOWBOARDING
EXERCISE_TYPE_SNOWSHOEING
EXERCISE_TYPE_SOCCER
EXERCISE_TYPE_SOFTBALL
EXERCISE_TYPE_SQUASH
EXERCISE_TYPE_STAIR_CLIMBING
EXERCISE_TYPE_STAIR_CLIMBING_MACHINE
EXERCISE_TYPE_STRENGTH_TRAINING
EXERCISE_TYPE_STRETCHING
EXERCISE_TYPE_SURFING
EXERCISE_TYPE_SWIMMING_OPEN_WATER
EXERCISE_TYPE_SWIMMING_POOL
EXERCISE_TYPE_TABLE_TENNIS
EXERCISE_TYPE_TENNIS
EXERCISE_TYPE_VOLLEYBALL
EXERCISE_TYPE_WALKING
EXERCISE_TYPE_WATER_POLO
EXERCISE_TYPE_WEIGHTLIFTING
EXERCISE_TYPE_WHEELCHAIR
EXERCISE_TYPE_OTHER_WORKOUT
EXERCISE_TYPE_YOGA

Tipos de datos agregados

EXERCISE_DURATION_TOTAL
Pisos subidos

  • Tipo de registro: Intervalo

  • Campos obligatorios

    floors
    endTime
    metadata
    startTime
Actividad FloorsClimbedRecord

android.permission.health.READ_FLOORS_CLIMBED
android.permission.health.WRITE_FLOORS_CLIMBED

Tipos de datos agregados

FLOORS_CLIMBED_TOTAL
Frecuencia cardíaca

  • Tipo de registro: Serie

  • Campos obligatorios

    samples
    endTime
    metadata
    startTime
Vitals HeartRateRecord

android.permission.health.READ_HEART_RATE
android.permission.health.WRITE_HEART_RATE

Tipos de datos agregados

BPM_AVG
BPM_MAX
BPM_MIN
MEASUREMENTS_COUNT
Variabilidad del ritmo cardíaco

  • Tipo de registro: Instantáneo

  • Campos obligatorios

    heartRateVariabilityMillis
    metadata
    time
Vitals HeartRateVariabilityRmssdRecord

android.permission.health.READ_HEART_RATE_VARIABILITY
android.permission.health.WRITE_HEART_RATE_VARIABILITY

Height

  • Tipo de registro: Instantáneo
  • Unidad: Longitud

  • Campos obligatorios

    height
    metadata
    time
Medidas corporales HeightRecord

android.permission.health.READ_HEIGHT
android.permission.health.WRITE_HEIGHT

Tipos de datos agregados

HEIGHT_AVG
HEIGHT_MAX
HEIGHT_MIN
Hidratación

  • Tipo de registro: Intervalo
  • Unidad: Volumen

  • Campos obligatorios

    endTime
    metadata
    startTime
    volume
Nutrición HydrationRecord

android.permission.health.READ_HYDRATION
android.permission.health.WRITE_HYDRATION

Tipos de datos agregados

VOLUME_TOTAL
Sangrado intermenstrual

  • Tipo de registro: Instantáneo

  • Campos obligatorios

    metadata
    time
Seguimiento del ciclo IntermenstrualBleedingRecord

android.permission.health.READ_INTERMENSTRUAL_BLEEDING
android.permission.health.WRITE_INTERMENSTRUAL_BLEEDING

Masa corporal magra

  • Tipo de registro: Instantáneo
  • Unidad: Masa

  • Campos obligatorios

    mass
    metadata
    time
Medidas corporales LeanBodyMassRecord

android.permission.health.READ_LEAN_BODY_MASS
android.permission.health.WRITE_LEAN_BODY_MASS

Menstruation


Para MenstruationFlowRecord:
  • Tipo de registro: Instantáneo

  • Campos obligatorios

    flow
    metadata
    time

Para MenstruationPeriodRecord:
  • Tipo de registro: Intervalo

  • Campos obligatorios

    endTime
    metadata
    startTime
Seguimiento del ciclo MenstruationFlowRecord

MenstruationPeriodRecord

android.permission.health.READ_MENSTRUATION
android.permission.health.WRITE_MENSTRUATION


Mindfulness

  Guía para registrar la actividad de mindfulness
  • Tipo de registro: Intervalo

  • Campos obligatorios

    endTime
    metadata
    mindfulnessSessionType
    startTime
Bienestar MindfulnessSessionRecord

android.permission.health.READ_MINDFULNESS
android.permission.health.WRITE_MINDFULNESS

FEATURE_MINDFULNESS_SESSION

Tipos de datos agregados

MINDFULNESS_DURATION_TOTAL
Nutrition

  • Tipo de registro: Intervalo
  • Unidad: Masa

  • Campos obligatorios

    endTime
    mealType
    metadata
    startTime
Nutrición NutritionRecord

android.permission.health.READ_NUTRITION
android.permission.health.WRITE_NUTRITION

Tipos de datos agregados

BIOTIN_TOTAL
CAFFEINE_TOTAL
CALCIUM_TOTAL
CHLORIDE_TOTAL
CHOLESTEROL_TOTAL
CHROMIUM_TOTAL
COPPER_TOTAL
DIETARY_FIBER_TOTAL
ENERGY_FROM_FAT_TOTAL
ENERGY_TOTAL
FOLATE_TOTAL
FOLIC_ACID_TOTAL
IODINE_TOTAL
IRON_TOTAL
MAGNESIUM_TOTAL
MANGANESE_TOTAL
MOLYBDENUM_TOTAL
MONOUNSATURATED_FAT_TOTAL
NIACIN_TOTAL
PANTOTHENIC_ACID_TOTAL
PHOSPHORUS_TOTAL
POLYUNSATURATED_FAT_TOTAL
POTASSIUM_TOTAL
PROTEIN_TOTAL
RIBOFLAVIN_TOTAL
SATURATED_FAT_TOTAL
SELENIUM_TOTAL
SODIUM_TOTAL
SUGAR_TOTAL
THIAMIN_TOTAL
TOTAL_CARBOHYDRATE_TOTAL
TOTAL_FAT_TOTAL
TRANS_FAT_TOTAL
UNSATURATED_FAT_TOTAL
VITAMIN_A_TOTAL
VITAMIN_B12_TOTAL
VITAMIN_B6_TOTAL
VITAMIN_C_TOTAL
VITAMIN_D_TOTAL
VITAMIN_E_TOTAL
VITAMIN_K_TOTAL
ZINC_TOTAL
Prueba de ovulación

  • Tipo de registro: Instantáneo

  • Campos obligatorios

    metadata
    result
    time
Seguimiento del ciclo OvulationTestRecord

android.permission.health.READ_OVULATION_TEST
android.permission.health.WRITE_OVULATION_TEST

Saturación de oxígeno

  • Tipo de registro: Instantáneo

  • Campos obligatorios

    metadata
    percentage
    time
Vitals OxygenSaturationRecord

android.permission.health.READ_OXYGEN_SATURATION
android.permission.health.WRITE_OXYGEN_SATURATION

Ejercicio planificado

  Guía de planes de entrenamiento
  • Tipo de registro: Intervalo

  • Campos obligatorios

    block
    endTime
    exerciseType
    hasExplicitTime
    metadata
Actividad PlannedExerciseSessionRecord

android.permission.health.READ_PLANNED_EXERCISE
android.permission.health.WRITE_PLANNED_EXERCISE

FEATURE_PLANNED_EXERCISE
Alimentación

  • Tipo de registro: Serie

  • Campos obligatorios

    endTime
    samples
    metadata
    startTime
Actividad PowerRecord

android.permission.health.READ_POWER
android.permission.health.WRITE_POWER

Tipos de datos agregados

POWER_AVG
POWER_MAX
POWER_MIN
Frecuencia respiratoria

  • Tipo de registro: Instantáneo

  • Campos obligatorios

    metadata
    rate
    time
Vitals RespiratoryRateRecord

android.permission.health.READ_RESPIRATORY_RATE
android.permission.health.WRITE_RESPIRATORY_RATE

Frecuencia cardíaca en reposo

  • Tipo de registro: Instantáneo

  • Campos obligatorios

    beatsPerMinute
    metadata
    time
Vitals RestingHeartRateRecord

android.permission.health.READ_RESTING_HEART_RATE
android.permission.health.WRITE_RESTING_HEART_RATE

Tipos de datos agregados

BPM_AVG
BPM_MAX
BPM_MIN
Actividad sexual

  • Tipo de registro: Instantáneo

  • Campos obligatorios

    metadata
    protectionUsed
    time
Seguimiento del ciclo SexualActivityRecord

android.permission.health.READ_SEXUAL_ACTIVITY
android.permission.health.WRITE_SEXUAL_ACTIVITY

Temperatura cutánea

  Guía para medir la temperatura cutánea
  • Tipo de registro: Serie
  • Unidad: Temperatura

  • Campos obligatorios

    deltas
    endTime
    measurementLocation
    metadata
    startTime
Vitals SkinTemperatureRecord

android.permission.health.READ_SKIN_TEMPERATURE
android.permission.health.WRITE_SKIN_TEMPERATURE

FEATURE_SKIN_TEMPERATURE

Tipos de datos agregados

TEMPERATURE_DELTA_AVG
TEMPERATURE_DELTA_MAX
TEMPERATURE_DELTA_MIN
Sesión de sueño

  Guía para hacer un seguimiento de las sesiones de sueño
  • Tipo de registro: Intervalo

  • Campos obligatorios

    endTime
    metadata
    stages
    startTime
Sueño SleepSessionRecord

android.permission.health.READ_SLEEP
android.permission.health.WRITE_SLEEP

Tipos de datos agregados

SLEEP_DURATION_TOTAL
Velocidad

  • Tipo de registro: Serie

  • Campos obligatorios

    endTime
    metadata
    samples
    startTime
Actividad SpeedRecord

android.permission.health.READ_SPEED
android.permission.health.WRITE_SPEED

Tipos de datos agregados

SPEED_AVG
SPEED_MAX
SPEED_MIN
Pasos


Para StepsRecord:
  • Tipo de registro: Intervalo

  • Campos obligatorios

    count
    endTime
    metadata
    startTime

Para StepsCadenceRecord:
  • Tipo de registro: Serie

  • Campos obligatorios

    endTime
    samples
    metadata
    startTime
Actividad StepsRecord

StepsCadenceRecord

android.permission.health.READ_STEPS
android.permission.health.WRITE_STEPS

Tipos de datos agregados para StepsRecord

COUNT_TOTAL

Tipos de datos agregados para StepsCadenceRecord

RATE_AVG
RATE_MAX
RATE_MIN
Total de calorías quemadas

  • Tipo de registro: Intervalo
  • Unidad: Energía

  • Campos obligatorios

    endTime
    energy
    metadata
    startTime
Actividad TotalCaloriesBurnedRecord

android.permission.health.READ_TOTAL_CALORIES_BURNED
android.permission.health.WRITE_TOTAL_CALORIES_BURNED

Tipos de datos agregados

ENERGY_TOTAL
VO2 máx.

  • Tipo de registro: Instantáneo

  • Campos obligatorios

    measurementMethod
    metadata
    time
    vo2MillilitersPerMinuteKilogram
Actividad Vo2MaxRecord

android.permission.health.READ_VO2_MAX
android.permission.health.WRITE_VO2_MAX

Peso

  • Tipo de registro: Instantáneo

  • Campos obligatorios

    metadata
    time
    weight
Medidas corporales WeightRecord

android.permission.health.READ_WEIGHT
android.permission.health.WRITE_WEIGHT

Tipos de datos agregados

WEIGHT_AVG
WEIGHT_MAX
WEIGHT_MIN
Impulsos en silla de ruedas

  • Tipo de registro: Intervalo

  • Campos obligatorios

    count
    endTime
    metadata
    startTime
Actividad WheelchairPushesRecord

android.permission.health.READ_WHEELCHAIR_PUSHES
android.permission.health.WRITE_WHEELCHAIR_PUSHES

Tipos de datos agregados

COUNT_TOTAL