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

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

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

지원되는 데이터 유형

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

표: Google Health API 칼로리 데이터 유형
데이터 유형
  dataType
  filter 매개변수		 기록
유형		 사용 가능한
작업		 범위 웹훅
지원		 True zeros
지원
활동 에너지 소모량
  active-energy-burned
  active_energy_burned 		인터벌 list, reconcile, rollup, dailyRollup .activity_and_fitness.readonly
.activity_and_fitness.writeonly
총 칼로리
  total-calories
  total_calories 		인터벌 rollup, dailyRollup .activity_and_fitness.readonly
.activity_and_fitness.writeonly

다음 섹션에서는 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
}

가이드라인

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

  • 일일 개요: 전체 일일 칼로리 소비량을 표시하려면 total-calories 데이터 유형의 일일 롤업을 요청합니다.
  • 활동 전용 소비량: 특정 운동 중 또는 휴식 대사율을 제외한 하루 동안 소모된 칼로리를 추적하려면 active-energy-burned를 쿼리합니다.
이전
데이터 유형 색인
다음
운동