대부분의 문서 페이지에서는 압축된 API 탐색기가 화면 오른쪽에 표시됩니다. API 탐색기가 표시되지 않으면 사용해 보기를 클릭하여 API 탐색기의 압축 버전을 표시합니다.
참조 문서 페이지의 오른쪽에 사용해 보기가 표시되지 않으면 이 메서드가 API 탐색기에서 지원되지 않는 것입니다. 예를 들어 API 탐색기는 서비스 계정이 필요한 API와 호환되지 않으므로 해당 API의 문서 페이지에 표시되지 않습니다.
API 탐색기의 확장된 버전 표시
API 탐색기의 확장된 버전에는 cURL, HTTP 및 기타 코드 샘플이 포함되어 있습니다. API 탐색기의 확장된 버전을 표시하려면 전체 화면 을 클릭합니다.
메서드 실행
API 탐색기를 사용하면 필수 매개변수, 선택적 매개변수, API 메서드의 요청 본문(해당하는 경우)을 입력할 수 있습니다. 목록 메서드와 같은 많은 REST 메서드의 경우 메서드를 실행하기 전에 한두 개의 필드만 입력하면 됩니다. 예를 들어 Books API'의 books.volumes.list 메서드는 책을 나열하기 위한 쿼리 매개변수(q)만 있으면 됩니다. books.volumes.list 메서드를 사용해 보려면 다음 단계를 따르세요.
books.volumes.list로 이동합니다.- API 탐색기가 표시되지 않으면 사용해 보기를 클릭합니다.
q필드에 격자 게임 (따옴표 또는 특수문자 없이)을 입력합니다.- 아래로 스크롤하여 실행을 클릭합니다.
- (선택사항) Google 로그인 화면에 Google 계정을 선택하라는 메시지가 표시됩니다.
- (선택사항) Google 승인 대화상자에서 책을 관리해도 괜찮은지 묻습니다. 허용을 클릭합니다. 실행 버튼 아래에 결과가 표시됩니다.
API 탐색기의 결과가 200이면 메서드가 성공적으로 처리된 것입니다.
API 탐색기 문제 해결
401 또는 403 오류가 발생했습니다.
API 탐색기를 사용하여 메서드를 실행할 때 401 또는 403 오류가 표시된다면 다음 중 하나의 문제 때문일 수 있습니다.
- 잘못된 승인 유형 (OAuth 2.0 대신 API 키)을 사용하고 있습니다. 승인 유형을 전환해 보세요.
- OAuth 2.0을 사용하지만 범위가 너무 좁습니다. 더 넓은 범위를 사용해 보세요.
승인 대화상자가 표시되지 않음
API 탐색기에서는 팝업을 사용하여 비공개 데이터에 대한 액세스 권한을 부여합니다. 브라우저에서 팝업을 차단하면 팝업이 표시되지 않고 액세스 권한을 부여할 수 없게 됩니다.
승인 대화상자에서 허용을 클릭했을 때 아무런 일도 일어나지 않으면 브라우저의 팝업 설정을 변경하여 팝업을 사용 설정해 보세요.