ヘルスコネクトのデータ型

ヘルスコネクトは、健康とフィットネスに関するデータと医療記録データの両方を保存し、構造化します。アプリの要件を計画するには、まずヘルスコネクトが提供するデータ型と権限を理解することが重要です。

開発後、Google Play ストアにアプリを公開する準備をする際に、アプリのデータ使用を宣言し、アプリが使用するヘルスコネクトのデータ型へのアクセスを宣言する必要があります。そうしないと、特別な承認が必要なため、アプリがヘルスコネクトのデータ型にアクセスできないというエラー メッセージがユーザーに表示される可能性があります。

詳しくは、Google Play Console で健康アプリの申告を完了するをご覧ください。

データ型のカテゴリ

ヘルスコネクトは、可能な限りバリエーションを広げるため、ほとんどの健康とフィットネス用のアプリで使用されるデータ型をサポートしています。ヘルスコネクトは、健康とフィットネスのデータを包括的に表示し、保存できるようにすることを目的としています。これらのデータ型は、次のカテゴリに分類されます。

表: ヘルスコネクトのデータ型のカテゴリ
カテゴリ 説明
directions_run アクティビティ ユーザーが行ったアクティビティをキャプチャします。ランニングや水泳などの健康とフィットネスに関するアクティビティが該当します。
まっすぐにする 身体測定 ユーザーの体重や基礎代謝率など、身体に関する一般的なデータをキャプチャします。
fertile 月経周期の管理 排卵検査のバイナリ結果など、月経周期および関連するデータポイントをキャプチャします。
grocery Nutrition 水分摂取と栄養に関するデータ型をキャプチャします。前者は、ユーザーが一度に飲んだ水の量を表します。後者には、カロリー、糖分、マグネシウムなどのオプション フィールドがあります。
sleep_auto 睡眠 ユーザーの睡眠の長さと種類に関連するデータを継続的にキャプチャします。
vital_signs Vitals ユーザーの健康全般に関する重要な情報をキャプチャします。体温、血糖値、血圧、血中酸素飽和度などのデータが含まれます。
マインドフルネス ウェルネス ユーザーのメンタルヘルスとウェルビーイングに関連するデータをキャプチャします。

データ型のフィールド

ヘルスコネクトのデータ型テーブルには、各データ型の構造と要件を理解するのに役立つ複数のフィールド列が含まれています。これらの列は次のとおりです。

表: データ型フィールドの説明
フィールド 説明
スケジュール レコードタイプ データが特定の瞬間に記録されたものか、一定期間にわたって記録されたものかを示します。有効な値は、Interval、Instantaneous、Series です。
まっすぐにする 単位 データ型の測定単位（カロリー、メートル、回数など）。
star 必須フィールド これらのフィールドは、このデータ型のデータを書き込む際に、データの完全性と有用性を維持するために含める必要がある必須フィールドです。

健康とフィットネスに関するデータの種類

権限をリクエストする前に、アプリはまずマニフェストで権限を宣言する必要があります。詳しくは、クイック スタート ガイドの権限を宣言するをご覧ください。

アプリがバックグラウンドにあるときにデータを読み取る場合や、履歴データを読み取る場合は、データ型の権限とは別に、読み取り権限の追加セットを宣言する必要があります。

表: ヘルスコネクトのデータ型の追加の読み取り権限
追加の読み取り権限 権限の申告
バックグラウンドでデータを読み取る
  バックグラウンド読み取りの例ガイド 		android.permission.health.READ_HEALTH_DATA_IN_BACKGROUND
過去のデータを読み取る
  30 日以上前のデータを読み取るガイド 		android.permission.health.READ_HEALTH_DATA_HISTORY

1. Jetpack のバージョンを選択する

権限の宣言は Jetpack のバージョンによって異なります。アプリで使用している Jetpack のバージョン範囲を選択してください。

2. データ型テーブルをフィルタする

次の表に、データ型の完全なリストと、各データ型のカテゴリ、機能フラグとガイド、権限の宣言を示します。

表: ヘルスコネクトのデータ型
データ型
  機能ガイド		 カテゴリ レコードタイプ
権限の宣言
フィーチャー トグル
活動中の消費カロリー

  • レコードタイプ: Interval
  • 単位: エネルギー

  • 必須フィールド

    endTime
    energy
    metadata
    startTime
アクティビティ ActiveCaloriesBurnedRecord

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

集約データ型

ACTIVE_CALORIES_TOTAL
アクティビティの強度

  • レコードタイプ: Interval

  • 必須フィールド

    activityIntensityType
    endTime
    metadata
    startTime
アクティビティ ActivityIntensityRecord

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

FEATURE_ACTIVITY_INTENSITY

集約データ型

DURATION_TOTAL
INTENSITY_MINUTES_TOTAL
MODERATE_DURATION_TOTAL
VIGOROUS_DURATION_TOTAL
基礎体温

  • レコードタイプ: 瞬時値
  • 単位: 温度

  • 必須フィールド

    temperature
    measurementLocation
    metadata
    time
月経周期の管理 BasalBodyTemperatureRecord

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

基礎代謝率

  • レコードタイプ: 瞬時値
  • 単位: 電力

  • 必須フィールド

    basalMetabolicRate
    metadata
    time
身体測定 BasalMetabolicRateRecord

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

集約データ型

BASAL_CALORIES_TOTAL
血糖値

  • レコードタイプ: 瞬時値

  • 必須フィールド

    level
    specimenSource
    mealType
    relationToMeal
    metadata
    time
バイタル BloodGlucoseRecord

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

血圧

  • レコードタイプ: 瞬時値
  • 単位: 気圧

  • 必須フィールド

    systolic
    diastolic
    bodyPosition
    measurementLocation
    metadata
    time
バイタル BloodPressureRecord

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

集約データ型

DIASTOLIC_AVG
DIASTOLIC_MAX
DIASTOLIC_MIN
SYSTOLIC_AVG
SYSTOLIC_MAX
SYSTOLIC_MIN
体脂肪率

  • レコードタイプ: 瞬時値

  • 必須フィールド

    percentage
    metadata
    time
身体測定 BodyFatRecord

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

体温

  • レコードタイプ: 瞬時値
  • 単位: 温度

  • 必須フィールド

    temperature
    measurementLocation
    metadata
    time
バイタル BodyTemperatureRecord

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

体水分量

  • レコードタイプ: 瞬時値
  • 単位: 質量

  • 必須フィールド

    mass
    metadata
    time
身体測定 BodyWaterMassRecord

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

骨量

  • レコードタイプ: 瞬時値
  • 単位: 質量

  • 必須フィールド

    mass
    metadata
    time
身体測定 BoneMassRecord

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

子宮頸管粘液

  • レコードタイプ: 瞬時値

  • 必須フィールド

    appearance
    sensation
    metadata
    time
月経周期の管理 CervicalMucusRecord

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

サイクリング ペダル ケイデンス

  • レコードタイプ: シリーズ

  • 必須フィールド

    samples
    endTime
    metadata
    samples
    startTime
アクティビティ CyclingPedalingCadenceRecord

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

集約データ型

RPM_AVG
RPM_MAX
RPM_MIN
距離

  • レコードタイプ: Interval
  • 単位: 長さ

  • 必須フィールド

    distance
    endTime
    metadata
    startTime
アクティビティ DistanceRecord

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

集約データ型

DISTANCE_TOTAL
獲得標高

  • レコードタイプ: Interval
  • 単位: 長さ

  • 必須フィールド

    elevation
    endTime
    metadata
    startTime
アクティビティ ElevationGainedRecord

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

集約データ型

ELEVATION_GAINED_TOTAL
エクササイズ

  エクササイズ ルートを追加するガイド
  • レコードタイプ: Interval

  • 必須フィールド

    exerciseType
    endTime
    laps
    metadata
    segments
    startTime
アクティビティ ExerciseSessionRecord

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

エクササイズの種類

すべてのエクササイズ タイプを表示
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

集約データ型

EXERCISE_DURATION_TOTAL
上った階数

  • レコードタイプ: Interval

  • 必須フィールド

    floors
    endTime
    metadata
    startTime
アクティビティ FloorsClimbedRecord

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

集約データ型

FLOORS_CLIMBED_TOTAL
心拍数

  • レコードタイプ: シリーズ

  • 必須フィールド

    samples
    endTime
    metadata
    startTime
バイタル HeartRateRecord

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

集約データ型

BPM_AVG
BPM_MAX
BPM_MIN
MEASUREMENTS_COUNT
心拍変動

  • レコードタイプ: 瞬時値

  • 必須フィールド

    heartRateVariabilityMillis
    metadata
    time
バイタル HeartRateVariabilityRmssdRecord

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

高さ

  • レコードタイプ: 瞬時値
  • 単位: 長さ

  • 必須フィールド

    height
    metadata
    time
身体測定 HeightRecord

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

集約データ型

HEIGHT_AVG
HEIGHT_MAX
HEIGHT_MIN
水分補給

  • レコードタイプ: Interval
  • 単位: Volume

  • 必須フィールド

    endTime
    metadata
    startTime
    volume
栄養 HydrationRecord

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

集約データ型

VOLUME_TOTAL
中間期出血

  • レコードタイプ: 瞬時値

  • 必須フィールド

    metadata
    time
月経周期の管理 IntermenstrualBleedingRecord

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

除脂肪体重

  • レコードタイプ: 瞬時値
  • 単位: 質量

  • 必須フィールド

    mass
    metadata
    time
身体測定 LeanBodyMassRecord

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

Menstruation


MenstruationFlowRecord の場合:
  • レコードタイプ: 瞬時値

  • 必須フィールド

    flow
    metadata
    time

MenstruationPeriodRecord の場合:
  • レコードタイプ: Interval

  • 必須フィールド

    endTime
    metadata
    startTime
月経周期の管理 MenstruationFlowRecord

MenstruationPeriodRecord

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


マインドフルネス

  マインドフルネスを記録するガイド
  • レコードタイプ: Interval

  • 必須フィールド

    endTime
    metadata
    mindfulnessSessionType
    startTime
ウェルネス MindfulnessSessionRecord

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

FEATURE_MINDFULNESS_SESSION

集約データ型

MINDFULNESS_DURATION_TOTAL
栄養

  • レコードタイプ: Interval
  • 単位: 質量

  • 必須フィールド

    endTime
    mealType
    metadata
    startTime
栄養 NutritionRecord

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

集約データ型

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
排卵検査

  • レコードタイプ: 瞬時値

  • 必須フィールド

    metadata
    result
    time
月経周期の管理 OvulationTestRecord

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

酸素飽和度

  • レコードタイプ: 瞬時値

  • 必須フィールド

    metadata
    percentage
    time
バイタル OxygenSaturationRecord

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

予定されたエクササイズ

  トレーニング プラン ガイド
  • レコードタイプ: Interval

  • 必須フィールド

    block
    endTime
    exerciseType
    hasExplicitTime
    metadata
アクティビティ PlannedExerciseSessionRecord

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

FEATURE_PLANNED_EXERCISE
電源

  • レコードタイプ: シリーズ

  • 必須フィールド

    endTime
    samples
    metadata
    startTime
アクティビティ PowerRecord

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

集約データ型

POWER_AVG
POWER_MAX
POWER_MIN
呼吸数

  • レコードタイプ: 瞬時値

  • 必須フィールド

    metadata
    rate
    time
バイタル RespiratoryRateRecord

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

安静時の心拍数

  • レコードタイプ: 瞬時値

  • 必須フィールド

    beatsPerMinute
    metadata
    time
バイタル RestingHeartRateRecord

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

集約データ型

BPM_AVG
BPM_MAX
BPM_MIN
性行為

  • レコードタイプ: 瞬時値

  • 必須フィールド

    metadata
    protectionUsed
    time
月経周期の管理 SexualActivityRecord

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

皮膚温

  皮膚温の測定ガイド
  • レコードタイプ: シリーズ
  • 単位: 温度

  • 必須フィールド

    deltas
    endTime
    measurementLocation
    metadata
    startTime
バイタル SkinTemperatureRecord

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

FEATURE_SKIN_TEMPERATURE

集約データ型

TEMPERATURE_DELTA_AVG
TEMPERATURE_DELTA_MAX
TEMPERATURE_DELTA_MIN
睡眠セッション

  睡眠セッションを記録するガイド
  • レコードタイプ: Interval

  • 必須フィールド

    endTime
    metadata
    stages
    startTime
睡眠 SleepSessionRecord

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

集約データ型

SLEEP_DURATION_TOTAL
速度

  • レコードタイプ: シリーズ

  • 必須フィールド

    endTime
    metadata
    samples
    startTime
アクティビティ SpeedRecord

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

集約データ型

SPEED_AVG
SPEED_MAX
SPEED_MIN
手順


StepsRecord の場合:
  • レコードタイプ: Interval

  • 必須フィールド

    count
    endTime
    metadata
    startTime

StepsCadenceRecord の場合:
  • レコードタイプ: シリーズ

  • 必須フィールド

    endTime
    samples
    metadata
    startTime
アクティビティ StepsRecord

StepsCadenceRecord

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

StepsRecord の集計データ型

COUNT_TOTAL

StepsCadenceRecord の集計データ型

RATE_AVG
RATE_MAX
RATE_MIN
総消費カロリー

  • レコードタイプ: Interval
  • 単位: エネルギー

  • 必須フィールド

    endTime
    energy
    metadata
    startTime
アクティビティ TotalCaloriesBurnedRecord

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

集約データ型

ENERGY_TOTAL
最大酸素摂取量

  • レコードタイプ: 瞬時値

  • 必須フィールド

    measurementMethod
    metadata
    time
    vo2MillilitersPerMinuteKilogram
アクティビティ Vo2MaxRecord

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

重み

  • レコードタイプ: 瞬時値

  • 必須フィールド

    metadata
    time
    weight
身体測定 WeightRecord

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

集約データ型

WEIGHT_AVG
WEIGHT_MAX
WEIGHT_MIN
車椅子を押した回数

  • レコードタイプ: Interval

  • 必須フィールド

    count
    endTime
    metadata
    startTime
アクティビティ WheelchairPushesRecord

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

集約データ型

COUNT_TOTAL