Google 피트니스 REST API를 비롯한 Google 피트니스 API는 2026년에 지원 중단될 예정 입니다. 2024년 5월 1일부터 개발자는 이러한 API를 사용하도록 가입할 수 없습니다 .
이전할 API 또는 플랫폼에 관한 안내는 헬스 커넥트 이전 가이드 를 참고하세요. 헬스 커넥트와 Google Fit API 및 Fitbit Web API를 비교하려면 헬스 커넥트 비교 가이드 를 참고하세요.
헬스 커넥트 및 API와 통합하는 방법을 자세히 알아보세요.
의견 보내기
요청 승인
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
애플리케이션이 Fitness API로 전송하는 모든 요청에는 승인 토큰이 포함되어야 합니다. Google은 이 토큰을 사용하여 애플리케이션을 식별합니다.
승인 프로토콜
요청을 승인하려면 애플리케이션에서 OAuth 2.0 을 사용해야 합니다. 다른 승인 프로토콜은 지원되지 않습니다. 애플리케이션에서 Google 로그인 을 사용하는 경우 승인의 일부 측면이 자동으로 처리됩니다.
앱에서 액세스하려는 데이터 유형 은 범위 에 해당합니다. 데이터 유형에 액세스하려면 먼저 해당 범위가 민감하거나 제한 되어 있는지 확인하고 인증 신청 시 관련 단계를 따라야 합니다.
아래에 나온 요청 승인 의 3단계를 참고하세요.
OAuth 2.0을 사용하여 요청 승인하기
Fitness API에 대한 모든 요청은 인증된 사용자의 승인을 받아야 합니다.
OAuth 2.0의 세부 승인 과정 또는 '흐름'은 작성 중인 앱의 종류에 따라 다릅니다. 이 일반적인 프로세스는 모든 앱 유형에 적용됩니다.
애플리케이션을 만들 때 Google API 콘솔 을 사용하여 등록합니다. 그러면 Google에서 클라이언트 ID 및 클라이언트 보안 비밀번호와 같이 나중에 필요한 정보를 제공합니다.
Google API 콘솔에서 Fitness API를 활성화합니다. (API 콘솔의 목록에 해당 API가 없으면 이 단계를 건너뛰세요.)
인증을 신청 하고 앱에 특정 범위가 필요한 이유에 관한 지원 정보를 제출합니다. 앱에서 액세스해야 하는 데이터 유형 은 앱에서 요청해야 하는 범위 에 해당합니다.
앱이 인증되면 Google은 사용자에게 동의 화면을 표시하여 앱에서 사용자 데이터에 액세스할 수 있도록 승인할 것을 요청합니다.
사용자가 승인하면 Google은 애플리케이션에 단기 액세스 토큰을 제공합니다.
애플리케이션에서 액세스 토큰을 첨부하여 사용자 데이터를 요청합니다.
Google에서 요청과 토큰이 유효하다고 판단하면 요청된 데이터를 반환합니다.
참고: 일부 흐름에는 갱신 토큰을 사용하여 새 액세스 토큰을 가져오는 등의 추가 단계가 포함됩니다. 다양한 유형의 애플리케이션 흐름에 관한 자세한 내용은 Google의 OAuth 2.0 문서 를 참고하세요.
여기 에서 Fitness API의 OAuth 범위를 알아보세요.
각 데이터 유형에 필요한 범위 를 찾아보세요.
의견 보내기
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스 에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스 에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책 을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-31(UTC)
의견을 전달하고 싶나요?
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-08-31(UTC)"],[],[]]