애플리케이션의 OAuth를 구성하려면 OAuth 워크플로를 설정하고 Data Portability API OAuth 범위를 사용 설정합니다.
OAuth 워크플로 설정
애플리케이션의 OAuth 흐름을 설정하려면 Google ID 문서의 기본 단계를 따르세요.
대부분의 개발자는 OAuth 동의를 얻기 위해 서버 측 웹 앱 흐름을 사용하지만 JavaScript 웹 앱 흐름 또는 모바일 및 데스크톱 앱 흐름을 사용할 수도 있습니다.
Data Portability API OAuth 범위
OAuth용으로 Data Portability API 애플리케이션을 구성할 때 애플리케이션과 관련된 Data Portability API OAuth 범위를 사용 설정합니다. Data Portability API에서 지원되는 모든 OAuth 범위 목록은 Google API용 OAuth 2.0 범위를 참조하세요. 특정 서비스에서 지원하는 모든 리소스 그룹과 OAuth 범위 목록은 해당 서비스의 스키마 참조 페이지를 확인하세요.
OAuth 흐름에 Data Portability API 범위를 추가할 때 사용자가 전체 범위가 아닌 일부 범위에 동의할 수도 있습니다. 앱은 다음과 같은 방법으로 이러한 사례를 처리할 수 있어야 합니다.
- 부분 데이터 내보내기 허용
- 사용자에게 필요한 모든 범위를 선택하지 않았으며 정상적으로 실패했음을 알립니다.
- 사용자에게 나머지 동의 요청
사용자 동의를 통해 특정 동의에 대해 한 번의 데이터 내보내기가 허용된다는 점에 유의해야 합니다. 데이터를 다시 다운로드하려면 사용자의 새로운 동의를 받아야 합니다.
또한 OAuth 흐름 중에 앱은 동의에 사용된 Google 계정을 알지 못합니다. 애플리케이션이 수신하는 OAuth 토큰은 불투명합니다.
사용자가 데이터를 공유하는 방법에 대한 자세한 내용은 서드 파티와 데이터 사본 공유를 참조하세요.