Fitbit 데이터를 다루는 앱은 이제 “기존 API를 계속 호출하면 되는” 단계에 머물 수 없습니다. Google은 Fitbit 사용자 데이터를 조회하기 위해 Google Health API를 새로 설계했고, 앱 등록 방식, 인증 흐름, 데이터 유형, 엔드포인트 스키마, 응답 형식까지 바꿨습니다.1
이 전환 과정에서 ghealth가 주목받는 이유는 명확합니다. 터미널에서 Google Health API 데이터를 직접 확인하고, JSON으로 받아 개발·테스트·자동화에 활용할 수 있기 때문입니다.
ghealth는 무엇인가
ghealth는 Google Health API용 오픈소스 CLI입니다. 브라우저나 별도 앱 화면 없이 명령어로 건강 데이터를 조회할 수 있게 해주는 도구입니다.
공개 저장소 기준으로 ghealth는 Go로 빌드되는 단일 바이너리 형태를 지원하며, 40개 데이터 유형을 JSON 형식으로 노출한다고 설명합니다.2 JSON 출력은 스크립트, 데이터 파이프라인, 대시보드 프로토타입, AI 에이전트와 연결하기 쉽다는 장점이 있습니다.
다만 ghealth는 Google의 공식 릴리스가 아니라 커뮤니티 프로젝트로 봐야 합니다. 실제 업무에 사용하기 전에는 저장소의 유지관리 상태, 권한 처리 방식, 토큰 보관 방식, 라이선스 등을 확인하는 것이 좋습니다.3
핵심 변화는 CLI가 아니라 Google Health API 전환이다
ghealth를 이해하려면 먼저 Google Health API가 무엇을 바꾸는지 봐야 합니다. Google Health API는 Fitbit 사용자 데이터를 조회하기 위해 새로 설계된 API이며, 기존 Fitbit Web API와 등록·인증 체계가 다릅니다.1
가장 먼저 앱 등록 위치가 달라집니다. Fitbit Web API 앱은 dev.fitbit.com/apps에서 등록했지만, Google Health API 앱은 Google Cloud 콘솔에서 등록해야 합니다.4 따라서 Google Health API를 사용하려면 Google Cloud 프로젝트를 만들고, 해당 프로젝트에서 Google Health API를 사용 설정해야 합니다.4
인증도 Google OAuth 2.0 기반으로 바뀝니다. 기존 Fitbit 승인 방식 대신 Google OAuth 2.0을 사용하며, Google Health API 앱은 Google OAuth2 클라이언트 라이브러리만 지원합니다.4
엔드포인트도 달라집니다.
Fitbit Web API 승인 URL:
https://www.fitbit.com/oauth2/authorizeGoogle Health API 승인 URL:
https://accounts.google.com/o/oauth2/v2/authFitbit Web API 토큰 URL:
https://api.fitbit.com/oauth2/tokenGoogle Health API 토큰 URL:
https://oauth2.googleapis.com/token4
즉, 기존 Fitbit 토큰이나 승인 흐름을 그대로 옮겨 쓰는 방식은 적합하지 않습니다. 개발자가 실제로 준비해야 할 것은 단순한 API 호출 변경이 아니라, 사용자 동의와 토큰 관리 흐름의 재설계입니다.
ghealth를 어디에 활용할 수 있나
ghealth의 실용성은 “빠른 확인”과 “작은 자동화”에 있습니다. 예를 들어 걸음 수, 심박수, 수면, 체중 같은 데이터를 명령어로 조회하고 JSON으로 저장할 수 있습니다.2 새 API의 응답 구조를 확인하거나, 대시보드 개발 전에 데이터 모양을 검토하거나, 마이그레이션 중 기존 Fitbit Web API 결과와 Google Health API 결과를 비교하는 용도로 적합합니다.
반대로 운영 서비스의 핵심 인증 흐름을 ghealth에 의존하는 것은 신중해야 합니다. ghealth는 개발·테스트·분석을 돕는 CLI로 보고, 실제 제품에서는 Google OAuth 2.0 기반의 동의, 토큰 발급, 갱신, 보관 구조를 별도로 안정적으로 설계하는 편이 안전합니다.
개발자가 얻을 수 있는 실질적 이점
ghealth의 의미는 단순히 “Fitbit 데이터를 터미널에서 볼 수 있다”는 데 있지 않습니다. Google Health API로 전환할 때 개발자가 새 인증 체계와 JSON 응답 형식을 빠르게 이해할 수 있게 해주는 실험 도구라는 점에 더 큰 가치가 있습니다.
현실적인 접근은 다음과 같습니다.
Google Cloud 콘솔에서 Google Health API 사용 조건과 앱 등록 방식을 확인합니다.
OAuth 2.0 동의 흐름과 필요한 권한 범위를 검토합니다.
ghealth로 실제 응답 구조와 데이터 유형을 빠르게 확인합니다.
확인한 내용을 바탕으로 제품의 마이그레이션 및 토큰 관리 전략을 설계합니다.
결론적으로 ghealth는 Google Health API 전환기의 보조 도구입니다. 먼저 CLI로 데이터와 권한 범위를 검증하고, 그다음 운영 서비스에 맞는 인증·데이터 처리 구조를 설계하는 순서가 가장 실용적입니다.
1Overview Stay organized with collections Save and categorize content based on your preferences.
2GitHub - Google-Health-API/google-health-cli
이 노트는 보도·비평·교육·연구 목적으로 작성되었습니다. 저작권 문의가 있으시면 에서 알려주세요.