API 탐색기의 사용자 인증 정보 섹션을 사용하면 다양한 사용자 인증 정보와 범위로 테스트할 수 있습니다. 이 기능은 API 엔드포인트를 호출하는 데 필요한 최소한의 사용자 인증 정보와 범위를 사용하는 데 유용합니다.
다른 사용자 인증 정보로 테스트
기본적으로 OAuth 2 및 API 키 사용자 인증 정보 유형이 모두 선택되어 있습니다. 사용자 인증 정보 하나로만 테스트하려면 사용할 사용자 인증 정보 유형을 선택하고 다른 사용자 인증 정보 유형은 선택 해제합니다. 테스트에 사용할 사용자 인증 정보를 선택하는 일반적인 규칙은 다음과 같습니다.
Google 지도 데이터와 같은 공개 데이터에 액세스하는 방법을 사용하는 경우 API 키를 사용자 인증 정보로 사용할 수 있습니다. API 키를 선택하고 Google OAuth 2.0을 선택 해제합니다.
사용자의 Google Drive 데이터와 같은 비공개 데이터에 액세스하는 방법을 사용하는 경우 OAuth 2 인증 정보를 사용해야 합니다. API 키를 선택 해제하고 Google OAuth 2.0을 선택합니다.
결과가 200이면 데이터에 액세스하기에 사용자 인증 정보가 충분합니다. 결과가 401인 경우 OAuth 2 사용자 인증 정보를 사용하여 데이터에 액세스해야 합니다.
다양한 범위로 테스트
범위는 https://www.googleapis.com/auth/drive.metadata.readonly와 같은 문자열로, 사용자 소유 데이터에 대한 액세스 수준과 같이 앱에 필요한 리소스에 대한 액세스 수준을 정의합니다. 앱이 사용자 데이터에 대한 액세스 수준이 가장 좁은 범위를 사용해야 합니다. 메서드에 따라 다른 범위가 필요할 수 있습니다. 예를 들어 API의 한 메서드에는 최소한 읽기 전용 범위가 필요하지만 다른 메서드에는 읽기-쓰기 범위가 필요할 수 있습니다.
기본적으로 API 탐색기에서는 API의 모든 Google OAuth 2.0 범위가 사용 설정됩니다. 특정 범위로 테스트하려면 다음 단계를 따르세요.
- 사용자 인증 정보 Google OAuth 2.0 섹션에서 범위 표시를 클릭합니다.
- 메서드를 호출할 때 사용할 범위를 확인합니다.
- 실행을 클릭하여 선택한 범위만 사용하여 API를 실행합니다. API 탐색기에 범위를 사용할 액세스 권한을 부여하라는 승인 화면이 표시됩니다.
- 허용을 클릭합니다. 결과는 '실행' 버튼 아래에 표시됩니다.
API 탐색기에 'application/json' 아래에 200 결과가 표시되면 메서드를 호출하기에 범위가 충분합니다. API 탐색기에 403 결과가 표시되면 메서드를 호출하기에 범위가 부족한 것입니다. 더 넓은 범위를 시도해 보세요.
범위 선택에 관한 자세한 내용은 특정 Google API의 문서에 있는 인증 및 승인 섹션을 참고하세요.
새 범위로 테스트하기 위해 승인된 액세스 권한 취소
Google 승인 화면을 사용하여 승인을 승인한 후에는 사용자 인증 정보가 만료되지 않는 한 API 탐색기가 인증된 요청을 할 수 있는 권한이 유지됩니다. 범위를 선택 해제해도 이전에 승인된 사용자 인증 정보와 범위는 재설정되지 않습니다. 새 범위 구성으로 테스트하려면 이전에 승인된 사용자 인증 정보를 취소해야 합니다.
API 탐색기에서 사용되는 사용자 인증 정보를 취소하려면 다음 단계를 따르세요.
- 내 계정에 액세스할 수 있는 앱으로 이동합니다.
- 계정 액세스 권한이 있는 서드 파티 앱에서 Google API 탐색기를 클릭합니다.
- 액세스 권한 삭제를 클릭합니다.
- (선택사항) 문서 페이지를 새로고침하여 API 탐색기를 재설정합니다.