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의 메서드에는 최소한 읽기 전용 범위가 필요할 수 있지만 다른 메서드에는 읽기-쓰기 범위가 필요할 수 있습니다.
기본적으로 모든 Google OAuth 2.0 범위는 API 탐색기에서 사용 설정됩니다. 특정 범위로 테스트하는 방법은 다음과 같습니다.
- 사용자 인증 정보 Google OAuth 2.0 섹션에서 범위 표시를 클릭합니다.
- 메서드를 호출할 때 사용할 범위를 확인합니다.
- 실행을 클릭하여 선택한 범위만 사용하여 API를 실행합니다. API 탐색기에는 범위를 사용할 수 있는 액세스 권한을 부여하도록 요청하는 승인 화면이 표시됩니다.
- 허용을 클릭합니다. 실행 버튼 아래에 결과가 표시됩니다.
API 탐색기에서 "application/json" 아래에 200 결과를 표시하는 경우 범위에서는 이 메서드를 호출하기에 충분합니다. API 탐색기의 결과가 403으로 표시되면 메서드를 호출하기에 충분한 범위가 아닌 것입니다. 더 넓은 범위를 사용해 보세요.
범위 선택에 대한 자세한 내용은 특정 Google API 문서의 인증 및 승인 섹션을 참조하세요.
새 범위를 사용하여 테스트하도록 승인된 액세스 권한 취소
Google 승인 화면을 사용하여 승인을 승인하고 나면 사용자 인증 정보가 만료되지 않는 한 API 탐색기에서 인증된 요청을 할 수 있습니다. 범위를 선택 해제해도 이전에 승인된 사용자 인증 정보 및 범위는 재설정되지 않습니다. 새 범위 구성으로 테스트하려면 이전에 승인된 사용자 인증 정보를 취소해야 합니다.
API 탐색기에서 사용한 사용자 인증 정보를 취소하려면 다음 단계를 따르세요.
- 내 계정에 액세스할 수 있는 앱으로 이동합니다.
- 계정 액세스 권한이 있는 타사 앱에서 Google API 탐색기를 클릭합니다.
- 액세스 권한 삭제를 클릭합니다.
- (선택사항) 문서 페이지를 새로고침하여 API 탐색기를 재설정합니다.