API 탐색기 표시 및 메서드 실행

대부분의 문서 페이지에서 축약된 API 탐색기가 화면 오른쪽에 표시됩니다. API 탐색기가 표시되지 않으면 사용해 보기를 클릭하여 API 탐색기의 축약 버전을 표시합니다.

참조 문서 페이지의 오른쪽에 사용해 보기가 표시되지 않으면 API 탐색기에서 해당 메서드를 지원하지 않는 것입니다. 예를 들어 API 탐색기는 서비스 계정이 필요한 API와 호환되지 않으므로 이러한 API의 문서 페이지에 표시되지 않습니다.

API 탐색기의 펼쳐진 버전 표시

확장된 버전의 API 탐색기에는 cURL, HTTP 및 기타 코드 샘플이 포함되어 있습니다. API 탐색기의 펼쳐진 버전을 표시하려면 전체 화면 을 클릭합니다.

메서드 실행

API 탐색기를 사용하면 API 메서드의 필수 매개변수, 선택적 매개변수, 요청 본문(해당하는 경우)을 입력할 수 있습니다. 목록 메서드와 같은 많은 REST 메서드의 경우 메서드를 실행하기 전에 하나 또는 두 개의 필드만 입력하면 됩니다. 예를 들어 Books API의 books.volumes.list 메서드는 도서를 나열하는 데 쿼리 매개변수 (q)만 필요합니다. books.volumes.list 메서드를 사용하려면 다음 단계를 따르세요.

  1. books.volumes.list로 이동합니다.
  2. API 탐색기가 표시되지 않으면 사용해 보기를 클릭합니다.
  3. q 필드에 Hunger Games를 입력합니다 (따옴표나 특수문자 제외).
  4. 아래로 스크롤하여 실행을 클릭합니다.
  5. (선택사항) Google 로그인 화면에서 Google 계정을 선택하라는 메시지가 표시됩니다.
  6. (선택사항) Google 승인 대화상자에서 '도서를 관리'해도 되는지 묻습니다. 허용을 클릭합니다. 결과는 '실행' 버튼 아래에 표시됩니다.

API 탐색기에 200 결과가 표시되면 메서드가 성공한 것입니다.

API 탐색기 문제 해결

401 또는 403 오류가 표시됨

API 탐색기를 사용하여 메서드를 실행할 때 401 또는 403 오류가 발생하면 다음 중 하나에 문제가 있을 수 있습니다.

  • 잘못된 승인 유형 (OAuth 2.0 대신 API 키)을 사용하고 있습니다. 승인 유형을 전환해 보세요.
  • OAuth 2.0을 사용하고 있지만 범위가 너무 좁습니다. 더 넓은 범위를 사용해 보세요.

승인 대화상자가 표시되지 않음

API 탐색기는 팝업을 사용하여 비공개 데이터에 대한 액세스 권한을 부여합니다. 브라우저에서 팝업을 차단하면 이 팝업이 표시되지 않아 액세스 권한을 부여할 수 없습니다.

승인 대화상자에서 허용을 클릭했는데 아무 일도 일어나지 않으면 브라우저의 팝업 설정을 변경하여 팝업을 사용 설정해 보세요.