「健康資料同步」資料類型

「健康資料同步」會儲存及建構健康與健身資料和醫療記錄資料。請務必先瞭解 Health Connect 提供的資料類型和權限，再規劃應用程式的需求。

開發完成後，準備將應用程式發布至 Play 商店時，您必須聲明應用程式的資料使用方式，以及聲明應用程式使用的 Health Connect 資料類型存取權。否則，系統可能會向使用者顯示錯誤訊息，指出應用程式無法存取需要特別核准的「健康資料同步」資料類型。

詳情請參閱「在 Play 管理中心填寫健康應用程式聲明」。

資料類型類別

為盡可能提供多樣化的資料，「健康資料同步」支援多數健康與健身應用程式使用的資料類型。健康資料同步致力於提供全方位健康與健身資料的總覽與儲存。這些資料類型可分為以下幾類：

表格：健康資料同步資料類型類別
類別 說明
directions_run 活動 擷取使用者進行的任何活動，可以包括各種健康與健身活動，例如跑步和游泳。
拉直 身體測量 擷取與身體相關的常見資料，例如使用者的體重和基礎代謝率。
fertile 週期追蹤 擷取月經週期及相關資料點，例如排卵測試的二元結果。
雜貨 營養 擷取水份和營養資料類型，前者代表使用者一次飲用的水量，後者則有卡路里、糖和鎂等選用欄位。
sleep_auto 睡眠 這會擷取與使用者睡眠時間間隔長度及睡眠類型相關的資料。
vital_signs Vitals 這會擷取關於使用者一般健康的重要資訊。包括體溫、血糖、血壓和血氧濃度等資料。
正念 健康 這會擷取與使用者心理健康和福祉相關的資料。

資料類型欄位

「健康資料同步資料類型」表格包含多個欄位，可協助您瞭解各資料類型的結構和需求。這些資料欄分別是：

表格：資料類型欄位說明
欄位 說明
時間表 Record Type 指出資料是在某個時間點或一段時間內記錄。可能的值包括： 間隔、即時、序列。
拉直 單位 資料類型的測量單位 (例如卡路里、公尺、次數)。
星號 必填欄位 這些是為這個資料類型撰寫資料時必須加入的重要欄位，有助於維持資料完整性和實用性。

健康與健身資料類型

要求任何權限之前，應用程式必須先在資訊清單中宣告權限。詳情請參閱快速入門指南的「宣告權限」一節。

如要在應用程式處於背景時讀取資料，或讀取歷史資料，必須另外宣告一組讀取權限，與資料類型權限分開：

表格：Health Connect 資料類型的其他讀取權限
額外讀取權限 權限宣告
在背景讀取資料
  背景讀取範例指南 		android.permission.health.READ_HEALTH_DATA_IN_BACKGROUND
讀取歷來資料
  讀取 30 天前資料指南 		android.permission.health.READ_HEALTH_DATA_HISTORY

1. 選取 Jetpack 版本

Jetpack 版本之間的權限聲明有所不同，請務必選取應用程式使用的 Jetpack 版本範圍。

2. 篩選資料類型表格

下表完整列出資料類型，並提供各類型的類別、功能旗標和指南，以及權限聲明。

表格：健康資料同步資料類型
資料類型
  功能指南		 類別 記錄類型
權限聲明
功能旗標
活動卡路里燃燒量

  • 記錄類型： 間隔
  • 單位： 能源

  • 必填欄位

    endTime
    energy
    metadata
    startTime
活動 ActiveCaloriesBurnedRecord

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

匯總資料類型

ACTIVE_CALORIES_TOTAL
活動強度

  • 記錄類型： 間隔

  • 必填欄位

    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
距離

  • 記錄類型： 間隔
  • 單位： 長度

  • 必填欄位

    distance
    endTime
    metadata
    startTime
活動 DistanceRecord

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

匯總資料類型

DISTANCE_TOTAL
爬升高度

  • 記錄類型： 間隔
  • 單位： 長度

  • 必填欄位

    elevation
    endTime
    metadata
    startTime
活動 ElevationGainedRecord

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

匯總資料類型

ELEVATION_GAINED_TOTAL
運動

  新增運動路線指南
  • 記錄類型： 間隔

  • 必填欄位

    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
爬樓梯數

  • 記錄類型： 間隔

  • 必填欄位

    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
補水

  • 記錄類型： 間隔
  • 單位： 音量

  • 必填欄位

    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：
  • 記錄類型： 間隔

  • 必填欄位

    endTime
    metadata
    startTime
經期追蹤 MenstruationFlowRecord

MenstruationPeriodRecord

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


正念

  追蹤正念指南
  • 記錄類型： 間隔

  • 必填欄位

    endTime
    metadata
    mindfulnessSessionType
    startTime
健康 MindfulnessSessionRecord

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

FEATURE_MINDFULNESS_SESSION

匯總資料類型

MINDFULNESS_DURATION_TOTAL
營養

  • 記錄類型： 間隔
  • 單位： 質量

  • 必填欄位

    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

預定運動

  訓練計畫指南
  • 記錄類型： 間隔

  • 必填欄位

    block
    endTime
    exerciseType
    hasExplicitTime
    metadata
活動 PlannedExerciseSessionRecord

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

FEATURE_PLANNED_EXERCISE
Power

  • 記錄類型： 系列

  • 必填欄位

    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
睡眠時間

  睡眠時間追蹤指南
  • 記錄類型： 間隔

  • 必填欄位

    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
步驟


步驟記錄：
  • 記錄類型： 間隔

  • 必填欄位

    count
    endTime
    metadata
    startTime

步驟頻率記錄：
  • 記錄類型： 系列

  • 必填欄位

    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
卡路里燃燒總量

  • 記錄類型： 間隔
  • 單位： 能源

  • 必填欄位

    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
推輪椅次數

  • 記錄類型： 間隔

  • 必填欄位

    count
    endTime
    metadata
    startTime
活動 WheelchairPushesRecord

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

匯總資料類型

COUNT_TOTAL