Google Health API에 오신 것을 환영합니다.
이 새로운 API는 Google OAuth를 활용하여 건강 데이터에 액세스하고 관리하기 위한 더 안전하고 사용자 친화적이며 확장 가능한 솔루션을 제공합니다. 다음과 같은 혜택이 있습니다.
보안 강화: 새 API는 API 설계 및 구현에 관한 Google의 현재 보안 권장사항 및 권장사항을 준수하여 취약점 위험을 줄입니다.
일관성: 새로운 API는 최신 API 설계 원칙을 따르므로 더 일관되고 직관적인 개발자 환경을 제공합니다.
미래 대비
- 확장성: 새로운 API는 증가하는 사용자 수와 데이터 유형을 지원하여 미래의 요구사항을 충족하도록 확장할 수 있도록 설계되었습니다.
- 유지관리 용이성: 표준화된 접근 방식을 채택하면 앱을 더 쉽게 유지관리하고 업데이트할 수 있어 기술 부채가 줄어듭니다.
- 새로운 기능 액세스: 새 API로 이전하면 새로운 기능과 기능이 출시될 때 액세스할 수 있으므로 앱이 최신 상태를 유지하고 최신 개선사항을 활용할 수 있습니다.
- 규정 준수: 새로운 API는 최신 Google 보안 및 개인 정보 보호 표준을 준수하므로 앱이 규정을 준수하도록 유지하는 데 필요한 노력이 줄어듭니다.
- 데이터 개인 정보 보호: Google OAuth 시스템은 다양한 데이터 개인 정보 보호 규정 (예: GDPR 및 HIPAA)을 준수하도록 설계되어 개발자의 규정 준수 부담을 간소화합니다.
시작 방법
개발을 시작하기 전에 Google Health API와의 통합을 시작하는 데 도움이 되는 단계 목록을 제공하는 개발자 체크리스트를 참고하세요.
시작하는 방법은 개발자 유형에 따라 다릅니다.
신규 개발자
Google API 또는 Google Cloud를 사용해 본 적이 없거나 복습이 필요한 경우, Codelab 중 하나를 살펴보는 것이 가장 쉽고 빠른 시작 방법입니다. Visual Studio Code 또는 OAuth 2.0 Playground를 사용하는 REST Codelab과 클라이언트 스텁을 가져오고 프로토콜 버퍼 정의를 컴파일하는 방법을 배우는 gRPC 전용 Python Codelab이 제공됩니다.
REST Codelab (VS Code) REST Codelab (OAuth 2.0 Playground) gRPC Codelab (Python)
Fitbit 개발자
기존 Fitbit Web API 개발자인 경우 먼저 이전 가이드를 읽어보는 것이 좋습니다. Fitbit Web API와 Google Health API의 모든 차이점을 강조하며, 마이그레이션 계획을 시작하는 데 필요한 안내를 제공합니다.
이 가이드에서는 사용자가 재인증 프로세스를 진행할 수 있도록 지원하는 권장사항과 UI 샘플도 강조합니다.
그런 다음 코드랩을 진행하거나 Google Cloud 설정이 완료되었는지 확인한 후 데이터 유형 가이드 중 하나를 사용하여 개발을 시작하세요.
프로토콜 선택
Google Health API는 REST 및 RPC 프로토콜을 모두 지원하여 개발자에게 건강 데이터 통합을 위한 확장 가능하고 고성능 기반을 제공합니다.
REST
REST는 표준 웹 개념과 JSON과 같은 사람이 읽을 수 있는 형식을 기반으로 하는 API 설계 접근 방식입니다. 브라우저 친화적이고 널리 지원되므로 공개 API와 웹 애플리케이션을 빌드하는 데 특히 적합합니다. 주요 강점은 외부 개발자를 위한 단순성과 접근성입니다.
gRPC
RPC는 프로토콜 버퍼라는 간결한 바이너리 형식을 사용하여 머신 간 통신을 용이하게 하는 고성능 시스템입니다. 효율적이고 스트리밍과 같은 고급 기능을 지원하므로 내부 마이크로서비스, 모바일-백엔드 통신, 실시간 업데이트에 적합합니다. RPC는 고성능 시나리오나 엄격한 인터페이스 계약이 필요한 경우에 적합합니다.
자세한 내용은 gRPC와 REST: gRPC, OpenAPI, REST 이해 및 API 설계 시 사용 시점을 참고하세요.
AI 지원 및 개발자 도구
이 사이트에서 Google의 AI 어시스턴트인 Gemini와 내장 개발자 도구를 사용하여 Google Health API 워크플로를 가속화할 수 있습니다. 탐색하는 동안 정보 패널에서 Gemini 채팅 및 코드 설명을 사용하여 복잡한 가이드를 요약하거나, 데이터 유형과 범위를 명확히 하거나, 코드 샘플을 내 언어에 맞게 조정할 수 있습니다. API 탐색기에서 라이브 요청을 테스트하고 JSON 응답을 프롬프트 컨텍스트로 사용하여 파싱 로직을 생성할 수도 있습니다.
Antigravity, Cursor, Claude Code 또는 맞춤 에이전트와 같은 AI 기반 도구로 개발하는 경우 페이지를 Markdown으로 내보내거나 Developer Knowledge MCP 서버를 통합하여 환경에서 Google Health API 참고 리소스에 직접 액세스할 수 있습니다. 이러한 워크플로를 사용하여 클라이언트 코드를 생성하거나 오류를 해결합니다. 자세한 내용은 AI 지원 및 개발자 도구를 참고하세요.
리소스
이 사이트에서는 시작하는 것 외에도 개발 및 이전 작업을 지원하는 포괄적인 리소스를 제공합니다.
- 지원: 도움이 필요하신가요? 지원 페이지에서 커뮤니티 포럼과 공개 Issue Tracker에 액세스하세요.
- Google Health API 패리티 도구: 이 도구를 사용하여 Fitbit Web API와 Google Health API 간의 엔드포인트와 기능을 비교합니다. 또한 LLM과 직접 사용하거나 선호하는 AI 도구의 Agents.md 파일의 일부로 사용할 수 있는 컨텍스트 파일도 제공됩니다.
- API 참조: 완전한 REST 참조 문서를 제공합니다.