사용자 데이터를 읽고 쓰는 모든 Google Health API 엔드포인트에는 하나 이상의 범위를 통해 데이터 수집에 대한 사용자 동의가 필요합니다. 앱은 Google의 OAuth2 인증 엔드포인트를 호출할 때 범위 목록을 제공해야 합니다. OAuth2 액세스 토큰 가져오기를 참고하세요. 발급된 액세스 토큰에는 동의한 사용자가 승인한 범위만 포함됩니다.
모든 Google Health API 범위는 다음으로 시작합니다.
https://www.googleapis.com/auth/googlehealth
구현
최고의 사용자 환경을 제공하고 보안 규정 준수를 보장하려면 범위를 요청할 때 다음을 충족해야 합니다.
- 필요한 범위만 요청: 애플리케이션이 작동하는 데 필요한 특정 데이터 범위에 대한 액세스만 요청합니다.
- 데이터를 전송할 때만 쓰기 액세스 권한 구성: Google Health에 데이터를 전송하는 경우에만 '쓰기' 액세스 권한 (예:
writeonly범위 사용)을 구성합니다. - 부분 동의를 적절하게 처리: 사용자가 동의 화면에 표시된 모든 범위를 선택하지 않더라도 애플리케이션이 실패해서는 안 됩니다.
- 애플리케이션이 표시된 모든 범위가 작동해야 하는 경우 '최상의 사용자 환경을 위해 모든 범위를 사용 설정하는 것이 좋습니다.'라는 텍스트를 표시할 수 있습니다.
사용 가능한 범위
| 범위 | 권한 |
|---|---|
| .activity_and_fitness.readonly | Google Health 활동 및 피트니스 데이터를 확인합니다. |
| .activity_and_fitness.writeonly | Google Health에 활동 및 피트니스 데이터를 추가하고, 추가한 데이터를 수정하거나 삭제 |
| .ecg.readonly | Google Health 심전도 데이터를 확인합니다. |
| .health_metrics_and_measurements.readonly | Google Health 건강 수치 및 측정 데이터를 확인합니다. |
| .health_metrics_and_measurements.writeonly | Google Health에 건강 수치 및 측정 데이터를 추가하고, 추가한 데이터를 수정하거나 삭제 |
| .irn.readonly | Google Health 불규칙한 심장 리듬 알림 데이터를 확인합니다. |
| .location.readonly | 운동 중에 기록된 Google Health GPS 위치를 확인합니다. |
| .nutrition.readonly | Google Health 영양 데이터를 확인합니다. |
| .nutrition.writeonly | Google Health에 영양 데이터를 추가하고, 추가한 데이터를 수정하거나 삭제 |
| .profile.readonly | Google Health 프로필 데이터를 확인합니다. |
| .profile.writeonly | Google Health에 프로필 데이터를 추가하고, 추가한 데이터를 수정하거나 삭제 |
| .settings.readonly | Google Health 설정 확인 |
| .settings.writeonly | Google Health에 설정 데이터를 추가하고, 추가한 데이터를 수정하거나 삭제 |
| .sleep.readonly | Google Health 수면 데이터를 확인합니다. |
| .sleep.writeonly | Google Health에 수면 데이터를 추가하고, 추가한 데이터를 수정하거나 삭제 |