출시 노트

2026년 5월 26일

새 범위

  • 심전도 데이터를 읽기 위한 .ecg.readonly
  • IRN 데이터를 읽기 위한 .irn.readonly

범위 이름 변경

읽기/쓰기 범위를 .writeonly로 바꿉니다. 이제 개발자는 읽기 및 쓰기 권한을 명시적으로 지정해야 합니다.

  • .activity_and_fitness가 이제 .activity_and_fitness.writeonly입니다.
  • .health_metrics_and_measurements는 이제 .health_metrics_and_measurements.writeonly입니다.
  • .nutrition는 이제 .nutrition.writeonly입니다.
  • .profile는 이제 .profile.writeonly입니다.
  • .settings는 이제 .settings.writeonly입니다.
  • .sleep이 이제 .sleep.writeonly입니다.

새 데이터 유형

다음 데이터 유형에 대한 지원이 추가되었습니다.

  • 활동 및 피트니스: active-energy-burned
  • ECG: electrocardiogram
  • 건강 수치 및 측정: core-body-temperature, blood-glucose
  • IRN: irregular-rhythm-notification
  • 영양: food, food-measurement-unit, nutrition-log

새 엔드포인트

웹훅

다음 웹훅 기능에 대한 지원이 추가되었습니다.

  • 구독자가 등록될 때 수동 구독 지원
  • 데이터 유형 activityLevel, bloodGlucose, dailyRespiratoryRate, heartRateVariability, height, hydrationLog, nutritionLog, respiratoryRateSleepSummary, runVo2Max, sedentaryPeriod, timeInHeartRateZone에 대한 알림 지원
  • Google Cloud Console에서 맞춤 측정항목, 알림, 구독자 오류 지원
  • 구독자와의 통신이 끊긴 경우 최대 7일 동안 실패한 웹훅 알림을 자동으로 재시도합니다.

주요 문서 업데이트

2026년 4월 14일

새 데이터 유형

  • 활동 및 피트니스: swim-lengths-data
  • 건강 수치 및 측정: height

새 엔드포인트

웹훅 지원

  • 구독자가 등록될 때 자동 구독 생성
  • project.subscribers 엔드포인트를 사용하여 구독을 수동으로 관리합니다.
  • 데이터 유형 activeZoneMinutes, altitude, bodyFat, caloriesInHeartRateZone, dailyHeartRateVariability, dailyHeartRateZones, dailyOxygenSaturation, dailyRestingHeartRate, dailySleepTemperatureDerivations, distance, exercise, floors, heartRate, sleep, steps, totalCalories, weight에 대한 알림 지원

추가 기능

  • GitHub의 REST 라이브러리: Google Health API REST 라이브러리는 GitHub 프로젝트 Google API에 포함된 모든 지원되는 클라이언트 라이브러리 에서 사용할 수 있습니다.
  • API 탐색기 지원: 엔드포인트는 참조 문서에 내장된 API 탐색기를 사용하여 호출할 수 있습니다.
  • OAuth 플레이그라운드 지원: Google Health API v4는 OAuth 2.0 플레이그라운드에 나열되어 있습니다. 이 도구를 사용하면 Google의 OAuth 라이브러리를 지원하는 엔드포인트를 호출할 수 있습니다.

2026년 3월 24일

Google Health API 출시 공지

Google Health API는 Fitbit Web API의 차세대 버전으로, 처음부터 개발되었으며 소중한 개발자 커뮤니티를 위해 설계되었습니다. 이 초기 출시에서는 개발자 커뮤니티에서 요청한 기능 추가와 함께 가장 많이 요청된 데이터 유형에서 Fitbit Web API와의 패리티를 달성하는 데 중점을 둡니다. 현재 사용 가능한 기능은 다음과 같습니다.

핵심 기능 하이라이트

  • 간소화된 설정: 익숙한 Google Cloud 콘솔을 통해 프로젝트를 등록하고 OAuth 클라이언트 ID를 직접 관리합니다.
  • 광범위한 플랫폼 지원: 모든 주요 프로그래밍 언어 및 플랫폼에서 원활하게 통합할 수 있도록 Google OAuth2 라이브러리를 기반으로 빌드합니다.
  • 간소화된 데이터 액세스: 여러 데이터 유형을 단일의 관리하기 쉬운 범위로 통합하는 새로운 범위 정의를 활용합니다.
  • 데이터 유형 전반에서 일관된 엔드포인트: 모든 데이터 유형에서 기능을 간소화하도록 설계된 새로운 균일한 엔드포인트와 필터 지원으로 더 간단한 코딩 여정을 경험해 보세요.
  • 포괄적인 데이터 범위: 여러 데이터 유형에서 읽기 및 쓰기 지원에 액세스합니다.
  • 실시간 알림: 자동 구독 생성 및 더 풍부한 알림 메시지 콘텐츠를 제공하는 향상된 웹훅 지원으로 업데이트를 즉시 수신합니다.
  • 기본 일중 지원: 목록 엔드포인트를 사용하여 세분화된 일중 데이터를 기본적으로 가져와 추가 단계를 없앱니다.
  • 전체 문서 모음: 다음을 비롯한 새로운 포괄적인 문서를 통해 빠르게 시작하고 실행할 수 있습니다.
    • 시작하기, API, 마이그레이션, 문제 해결 가이드
    • REST 전체 참조 가이드
    • 새로운 Google Health API 패리티 도구, 샘플 코드, 가이드 Codelab

지원되는 데이터 유형

이 출시를 통해 필수 데이터 유형에 액세스할 수 있으므로 혁신적인 건강 솔루션을 빌드하는 데 필요한 핵심 정보를 확보할 수 있습니다.

읽기를 지원하는 데이터 유형:

  • 활동 및 피트니스: 활동적 시간, 액티브존 미닛, 활동 수준, 고도, 심박수 구간의 칼로리, 일일 최대 산소 섭취량, 이동 거리, 운동, 층수, 러닝 최대 산소 섭취량, 앉아 있는 시간, 걸음, 심박수 구간의 시간, 총 칼로리, 최대 산소 섭취량
  • 건강 수치 및 측정: 체지방, 일일 심박 변이도, 일일 심박수 구간, 일일 산소 포화도, 일일 호흡수, 일일 안정 시 심박수, 일일 수면 온도 파생, 심박수, 심박 변이도, 산소 포화도, 호흡수 수면 요약, 체중
  • ID: Fitbit 사용자 ID 및 Google 사용자 ID를 반환합니다.
  • 위치: TCX 형식으로 노출된 기록된 운동을 기반으로 하는 GPS 데이터
  • 영양: 수분 섭취 기록
  • 프로필: 사용자 기본 프로필 정보
  • 설정: 사용자가 구성한 기기 및 모바일 앱 설정
  • 수면: 클래식 및 단계 수면 기록

쓰기를 지원하는 데이터 유형:

다음 데이터 유형의 데이터를 쓰고 수정할 수 있습니다.

  • 활동 및 피트니스: 운동
  • 건강 수치 및 측정: 체지방, 체중
  • 프로필
  • 설정
  • 수면

상호작용을 위한 주요 엔드포인트

구독, 사용자, 건강 및 피트니스 데이터를 관리하는 데 다음 엔드포인트를 사용할 수 있습니다.

  • users: ID 및 프로필 관리를 위한 getIdentity, getProfile, getSettings, updateProfile, updateSettings 메서드
  • users.dataTypes.dataPoints: 포괄적인 데이터 유형 관리를 위한 batchDelete, dailyRollUp, list, patch, reconcile, rollUp 메서드