출시 노트

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 Playground 지원: Google Health API v4는 Google의 OAuth 라이브러리를 지원하는 엔드포인트를 호출할 수 있는 도구인 OAuth 2.0 Playground에 나열되어 있습니다.

2026년 3월 24일

Google Health API 출시 공지

Google Health API는 Fitbit Web API의 차세대 버전으로, 처음부터 개발되었으며 Google의 소중한 개발자 커뮤니티를 위해 설계되었습니다. 이 초기 출시에서는 개발자 커뮤니티에서 요청한 기능 추가와 함께 가장 많이 요청된 데이터 유형에서 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 메서드