Google Health API 정보

Fitbit Web API는 개발자 통합을 위한 보다 표준화되고 일관되며 확장 가능한 기반을 제공하도록 개선 및 현대화되었으며, 이제 Google Health API라고 합니다. Google Health API는 기존 Fitbit Web API의 전략적 진화를 나타내며, Google의 최신 인프라를 기반으로 처음부터 다시 빌드되었습니다.

이 플랫폼을 통해 개발자는 Google Cloud 개발자 도구의 모든 기능을 활용할 수 있으며, 사용자는 익숙하고 간소화된 방식으로 Google OAuth 2.0을 통해 권한을 편리하게 관리할 수 있습니다.

Google Health API를 사용하면 어떤 이점이 있나요?

  • 통합된 정보 소스: 새로운 '조정된 스트림'은 여러 소스의 중복 데이터 포인트를 조정하는 복잡한 작업을 처리합니다. 이렇게 하면 앱에서 사용자가 Fitbit 앱 내에서 보는 것과 동일한 일관된 데이터를 표시할 수 있습니다. 이 스트림은 Fitbit 및 Pixel 기기의 데이터와 수동 입력이 포함된 퍼스트 파티 스트림 외에 제공됩니다.
  • 기술 현대화 및 성능: 100개가 넘는 기존 엔드포인트를 간소화된 데이터 유형 번들로 통합하고 데이터 형식, 시간대, 측정 단위, 오류 처리의 불일치를 제거했습니다. 또한 이제 고성능 데이터 검색을 위한 HTTP/REST 프로토콜을 지원합니다. 또한 이제 전용 목록 엔드포인트를 통해 모든 관련 데이터 유형에 대해 일중 데이터와 웹훅을 사용할 수 있습니다.
  • 향상된 웹훅 및 확장성: 차세대 AI 기반 건강 앱과 함께 확장되도록 설계된 모든 관련 데이터 유형에 대한 자동 구독 및 세부 관리를 포함하여 확장된 웹훅 지원의 이점을 누릴 수 있습니다.
  • 간소화된 ID 및 보안: 기존 Fitbit 승인(FOT)을 Google OAuth 2.0으로 대체합니다. 이를 통해 개발자는 표준 Google 인증 라이브러리를 활용하여 코드베이스를 간소화하는 동시에 사용자에게 권한을 관리하는 친숙하고 중앙 집중화된 방법을 제공할 수 있습니다. 모든 Google Health API 범위는 제한됨으로 분류되므로 액세스하려면 개인 정보 보호 및 보안 검토가 필요합니다.

표시된 내용이 마음에 드시나요? 지금 시작하기

API 버전 및 공개 베타 채널

Google Health API는 Google의 API 개선 제안서(AIP), 특히 AIP-185: API 버전 관리 및 AIP-181: 안정성 수준에 따라 채널 기반 버전 관리를 사용합니다. 이 API는 안정화 버전 v4 채널과 공개 베타 v4beta 채널이라는 두 가지 공개 채널을 통해 사용할 수 있습니다. Google은 표준 지원 채널을 통해 두 채널을 모두 지원합니다.

안정화 버전 채널과 베타 채널 비교

AIP-185에 따라 v4beta 채널은 안정적인 v4 채널의 상위 집합 역할을 합니다. 여기에는 모든 안정적인 v4 기능과 함께 파트너 테스트를 진행 중인 사전 체험판 데이터 유형, 필드, 메서드가 포함됩니다.

문서에서 베타 채널에서만 사용할 수 있는 API 요소에는 v4beta 라벨이 표시됩니다.

기능 안정화 버전 채널(v4) 공개 베타 채널(v4beta)
REST 기본 URI https://health.googleapis.com/v4 https://health.googleapis.com/v4beta
gRPC 패키지 google.devicesandservices.health.v4 google.devicesandservices.health.v4beta
참조 문서 v4 REST 및 v4 RPC v4beta REST 및 v4beta RPC
안정성 수준 프로덕션에 즉시 사용 가능하며 AIP-180 하위 호환성 규칙에 의거하여 관리됩니다. 불안정한 프리뷰는 언제든지 고지 없이 호환되지 않는 변경사항이 적용되거나 삭제될 수 있습니다.
사용 목적 실시간 사용자 대상 프로덕션 애플리케이션 초기 테스트, 프로토타입 제작, 스키마 검증, 개발자 의견 수렴
지원 표준 지원 채널을 통해 지원됩니다. 버그 신고, 문제 해결, 설계 의견을 위한 표준 지원 채널을 통해 지원됩니다.

v4beta 채널 처리 방법

v4beta로 태그된 기능을 살펴볼 때는 다음 가이드라인을 따르세요.

  • 주로 개발, 스테이징, 비프로덕션 테스트 환경에서 v4beta를 사용합니다. v4beta 엔드포인트 또는 베타 전용 데이터 유형에 종속된 프로덕션 기능을 출시하는 것은 권장되지 않습니다.
  • v4beta의 스키마, 필드 이름, 엔드포인트 동작, 데이터 표현은 경고 없이 변경될 수 있습니다. 베타 기능 및 데이터 유형은 검증 목표를 충족하지 못하는 경우 완전히 삭제될 수도 있습니다.
  • 베타 채널의 브레이킹 체인지가 핵심 v4 통합을 방해하지 않도록 기능 플래그 또는 별도의 모듈 뒤에 실험용 v4beta 클라이언트 코드를 격리합니다.
  • 표준 지원 채널을 통해 v4beta에 대한 지원을 받고, 문제를 신고하고, 구현 의견을 공유하여 최종 API 설계를 완성하는 데 도움을 주세요.

v4beta에서 안정화 버전 v4로 승격

새로운 데이터 유형과 기능은 안정적인 v4 채널로 전환되기 전에 파트너 테스트 및 시장 검증을 지원하기 위해 v4beta에 진입합니다.

Google은 베타 기능을 v4로 승격하기 전에 다음 기준에 따라 평가합니다.

  • 파트너 테스트를 통해 데이터 모델, 필드 시맨틱스, 쿼리 패턴이 실제 애플리케이션 요구사항을 충족하는지 확인합니다.
  • 개발자 의견 및 설계 검토가 완료되었으며 스키마를 AIP-180 하위 호환성 보장에 따라 잠글 수 있습니다.
  • 엔드 투 엔드 데이터 파이프라인, 기기 동기화, 서비스 안정성이 프로덕션 품질 표준을 충족합니다.
  • AIP-185 지원 중단 규칙에 따라 베타 테스트 중에 지원 중단된 필드나 동작은 v4로 승격되지 않고 삭제됩니다.

AIP-181은 베타 평가에 약 90일이라는 일반적인 경험 법칙을 제공하지만, 기능을 v4beta에서 v4로 승격하는 실제 시점은 기능 복잡성, 하드웨어 가용성, 검증 피드백에 따라 달라집니다. 일부 기능은 더 빨리 정식 버전으로 출시될 수 있지만, 다른 기능은 v4beta에 더 오래 남아 있거나 중단될 수 있습니다.

데이터 유형 또는 기능이 안정화 버전 v4 채널로 승격되면 Google은 출시 노트에서 승격을 발표합니다. 이 시점에서 통합을 프로덕션 사용자에게 출시하기 전에 요청을 https://health.googleapis.com/v4beta에서 https://health.googleapis.com/v4로 업데이트합니다.

Fitbit Web API는 어떻게 되나요?

기존 Fitbit Web API는 다음 일정에 따라 지원 중단되었습니다.

  • 2026년 9월 30일(지원 종료): Fitbit Web API 지원이 종료되었으며 Google에서 버그 수정을 중단하고 API 지원을 제공하지 않습니다.
  • 2026년 11월 2일(API 사용 중지): Fitbit Web API 및 Fitbit OAuth 엔드포인트가 사용 중지되었으며 더 이상 작동하지 않거나 Google Health 사용자와 데이터를 동기화하지 않습니다. 이러한 엔드포인트에 대한 요청은 실패하고 HTTP 410 Gone 상태 코드를 반환합니다.

기존 Fitbit Web API 및 Fitbit 승인을 사용하는 개발자는 애플리케이션과 사용자를 Google Health API 및 Google OAuth 2.0으로 이전해야 합니다.

시작하려면 이전 가이드를 참고하세요.

지원되는 기기는 무엇인가요?

현재 및 이전의 모든 Fitbit 기기와 Google Pixel Watch는 Google Health API를 통해 반환되는 데이터를 수집합니다. 사용 가능한 데이터 유형은 기기에서 지원하는 기능에 따라 다릅니다.

현재 기기 목록은 Google 스토어에서 확인할 수 있습니다.

의견은 어떻게 제공하나요?

보내주신 의견은 소중하게 활용됩니다. 지원 페이지에 나열된 지원 채널을 통해 의견을 공유해 주시기 바랍니다.

Google은 이러한 API가 개발자를 잘 지원할 수 있도록 최선을 다하고 있지만 Google Health API는 계속해서 발전하고 있습니다. 의견에 따라 지금부터 5월 말 사이에 변경사항이 도입될 수 있으며, 이 경우 해당 업데이트가 필요할 수 있습니다.

로드맵

2026년에 출시될 기능 목록입니다.

2026년 4분기

데이터 유형(읽기 및 쓰기)

  • 세분화된 피부 온도
  • 기초대사율
  • 헬스 커넥트와 동등한 수준에 도달하도록 데이터 유형을 추가할 예정입니다. 2026년 4분기와 2027년 1분기에 더 많은 헬스 커넥트 데이터 유형이 추가될 예정입니다.

기능

  • 새로운 데이터 유형을 사전 체험할 수 있는 공개 베타 채널
  • 웹훅 원격 분석을 모니터링하는 통계 엔드포인트