칼로리 및 에너지 데이터 유형

Google Health API는 사용자의 칼로리 및 에너지 소비량을 추적하는 데이터 유형을 제공합니다. 이러한 유형은 총 소모량, 활동 소모량, 안정 시 (기초) 대사율 등 에너지 소모의 다양한 측면을 측정합니다.

이러한 데이터 유형 간의 차이점을 이해하여 애플리케이션에 적합한 측정항목을 확인하세요.

지원되는 데이터 유형

이 API는 칼로리 및 에너지 소비량을 측정하기 위해 다음 데이터 유형을 지원합니다.

표: Google Health API 칼로리 데이터 유형
데이터 유형
  dataType
  filter 매개변수		 Record
type		 사용 가능한
작업		 범위 웹훅
지원		 True zeros
지원
활동 에너지 소모량
  active-energy-burned
  active_energy_burned 		간격 list, reconcile, rollup, dailyRollup activity_and_fitness
기초 에너지 소모량
  basal-energy-burned
  basal_energy_burned 		간격 목록, 조정 activity_and_fitness
기초대사율
  basal-metabolic-rate
  basal_metabolic_rate 		샘플 목록, 조정 영양

다음 섹션에서는 REST 표현 예시 및 구체적인 통합 제약 조건을 비롯한 각 데이터 유형의 기술 세부정보를 제공합니다.

총 칼로리

총 칼로리는 기초 대사량과 활동 에너지 등 사용자가 소모한 모든 에너지를 킬로칼로리 (kcal)로 측정하여 추적하는 읽기 전용 파생 데이터 유형입니다. 값은 활동 에너지 소비량과 사용자의 기초 대사율에서 계산됩니다.

참고: total-calories 데이터 유형에 대한 쿼리에는 시간 간격 필터 (예: total_calories.interval.start_time 또는 total_calories.interval.civil_start_time)가 포함되어야 합니다. 이러한 쿼리의 최대 범위는 14일입니다.

쿼리 예시

total-calories 데이터 유형을 쿼리하려면 간격 필터를 사용하여 list 엔드포인트에 요청을 보냅니다.

요청

GET https://health.googleapis.com/v4/users/me/dataTypes/total-calories/dataPoints?filter=total_calories.interval.start_time >= "2026-04-20T00:00:00Z" AND total_calories.interval.start_time < "2026-04-21T00:00:00Z"
Authorization: Bearer access-token
Accept: application/json

활동 에너지 소모량

활동 에너지 소모량은 사용자가 활동하는 동안 소모한 에너지를 나타내며, 기초 에너지 소모량을 제외한 값입니다. 단위는 킬로칼로리(kcal)입니다.

REST 표현 예시

{
  "startTime": "2026-04-20T08:00:00Z",
  "startUtcOffset": "0s",
  "endTime": "2026-04-20T08:30:00Z",
  "endUtcOffset": "0s",
  "dataSource": { ... },
  "kcal": 150.0
}

기초 에너지 소모량

기초 에너지 소모량은 시간 간격 동안 사용자의 휴식 대사로 인해 소모된 칼로리를 나타내며, 킬로칼로리 (kcal)로 측정됩니다.

참고: 이 데이터 유형에는 롤업 및 일일 롤업 작업을 사용할 수 없습니다. 일일 기초 에너지 값을 가져오려면 기초 대사율 데이터 유형을 사용하세요.

기초대사율

기초 대사율은 정상적인 안정 상태에서 신체가 소모하는 에너지를 측정하며, 단위는 하루당 킬로칼로리(kcal/day)입니다. 이 비율은 시간이 지남에 따라 체중과 같은 신체 업데이트에 따라 변동되므로 API는 BMR을 비율 샘플의 시계열로 기록합니다.

개발자는 basal-metabolic-rate 샘플의 rateKcalPerDay 필드를 소모된 기초 에너지의 일일 롤업에 상응하는 일일 값으로 취급할 수 있습니다.

REST 표현 예시

{
  "date": {
    "year": 2026,
    "month": 4,
    "day": 20
  },
  "dataSource": { ... },
  "rateKcalPerDay": 1650.0
}

가이드라인

앱에 칼로리 및 에너지 측정항목을 통합할 때는 다음 가이드라인을 따르세요.

  • 일일 개요: 전체 일일 칼로리 소모량을 표시하려면 total-calories 데이터 유형의 일일 롤업을 요청하세요.
  • 활동 전용 소모량: 특정 운동 중 또는 안정 시 대사율을 제외한 하루 종일 소모된 칼로리를 추적하려면 active-energy-burned를 쿼리하세요.
  • 기초 측정항목: 휴식 시 대사율 또는 기초 대사 추세를 추적하려면 basal-metabolic-rate에 BMR 값을 쿼리하세요. BMR 샘플을 사용자의 휴식 시 에너지 소비량의 일일 기준선으로 취급합니다.
이전
데이터 유형 색인