문제 해결

이 가이드에서는 Google Health API를 사용할 때 발생하는 일반적인 문제를 해결하는 방법을 설명합니다.

4xx 클라이언트 오류

클라이언트 앱 코드에 문제가 있으면 4xx 상태 코드가 반환됩니다. 문제에 관한 자세한 내용은 응답 본문 요소를 참고하세요.

400 잘못된 요청

메시지 설명 권장사항
요청에 잘못된 인수가 포함되어 있습니다. 데이터 유형 ID {value}는 지원되지 않습니다. 참조되는 데이터 유형이 엔드포인트에서 지원되는지 확인합니다.
잘못된 JSON 페이로드가 수신되었습니다. 8진수/16진수는 유효한 JSON 값이 아닙니다. dailyRollUp 엔드포인트는 각각 MM 또는 DD로 표시되는 월 및 일 값을 지원하지 않습니다. 한 자리 숫자는 앞에 0이 붙으면 안 됩니다.

401 승인되지 않음

메시지 설명 권장사항
요청에 잘못된 사용자 인증 정보가 있습니다. OAuth 2 액세스 토큰, 로그인 쿠키 또는 기타 유효한 사용자 인증 정보가 있어야 합니다. INVALID_AUTHENTICATOR: 토큰이 만료됨 액세스 토큰이 만료되었습니다. 갱신 토큰을 사용하여 새 액세스 토큰과 갱신 토큰을 가져오거나 사용자가 애플리케이션에 다시 동의해야 합니다.

403 금지됨

메시지 설명 권장사항
호출자에게 권한이 없습니다. GaiaMint에서 UberMint를 발행할 수 없습니다. 사용자가 승인 흐름을 완료할 수 있었지만 엔드포인트 호출이 실패했습니다. 이는 기존 Fitbit 계정이 Google 계정 대신 앱에 동의하는 경우에 발생할 수 있습니다. 이 오류를 해결하려면 다음 단계를 따르세요.
  1. Fitbit 설정을 통해 Fitbit 모바일 앱에서 로그아웃합니다.
  2. 'Google 계정으로 계속' 또는 'Google 계정으로 로그인' 버튼을 눌러 Fitbit 모바일 앱에 로그인합니다. '이 Google 계정으로 Fitbit을 사용할 수 없습니다'라는 메시지가 표시되면 이메일 주소가 아직 기존 Fitbit 계정으로 등록되어 있는 것입니다. 이 도움말의 단계에 따라 계정을 이전하세요.
  3. 새 Google 계정으로 Fitbit 모바일 앱에 로그인한 경우 동일한 이메일 주소를 사용하여 다시 동의해 보세요.

404 찾을 수 없음

메시지 설명 권장사항
요청된 URL /v4/users/me/dataTypes/{dataType}/dataPoints을(를) 이 서버에서 찾을 수 없습니다. 가능한 원인:
  • 올바른 동사가 사용되고 있는지 확인
  • 엔드포인트 문법에 오타가 없는지 확인

Fitbit 사용자 ID 가져오기

사용자 문제를 해결하려면 Fitbit 모바일 앱에 로그인한 사용자의 Google 계정을 확인해야 할 수 있습니다.

Fitbit 사용자 ID를 찾는 방법은 다음과 같습니다.

  1. Fitbit 모바일 앱을 엽니다.
  2. 오른쪽 하단에 있는 내 페이지 아이콘을 누릅니다.
  3. 사용자 이름과 가입일이 포함된 상단 타일에서 프로필 수정 링크를 누릅니다.
  4. 페이지 하단으로 이동합니다. 내 계정 섹션에서 ID에 할당된 값은 Fitbit 사용자 ID입니다. (예: CV5TKH)

사용자가 앱에 대한 OAuth2 연결 문제를 해결하도록 지원할 때 사용자가 앱에서 계정을 연결 해제한 후 승인 흐름을 다시 완료해야 할 수 있습니다.

Google 계정을 앱에서 연결 해제하려면 다음 단계를 따르세요.

  1. Fitbit 모바일 앱을 엽니다.
  2. 오른쪽 상단의 Fitbit 사용자 프로필 아이콘을 누릅니다.
  3. Google 계정 관리를 누릅니다.
  4. 데이터 및 개인 정보 보호 타일을 선택합니다.
  5. **사용 중인 앱 및 서비스의 데이터 섹션으로 이동합니다. 앱 및 서비스에서 서드 파티 앱 및 서비스를 선택합니다.
  6. 연결된 앱 목록에서 앱 이름을 찾아 사용자가 선택하도록 합니다.
  7. <앱 이름>과의 모든 연결 삭제를 누릅니다.
  8. 사용자가 확인을 눌러 앱에 대한 동의를 취소하도록 합니다.

취소 프로세스가 완료되면 사용자가 서드 파티 앱 및 서비스 페이지 목록으로 돌아갑니다. 사용자가 목록에서 앱 이름이 삭제된 것을 보려면 페이지를 새로고침해야 할 수 있습니다.