볼륨: list

도서 검색을 실행합니다. 지금 사용해 보기

요청

HTTP 요청

GET https://www.googleapis.com/books/v1/volumes?q={search terms}

파라미터

매개변수 이름 값 설명
필수 매개변수
q string 전체 텍스트 검색 쿼리 문자열
선택적 매개변수
download string 다운로드 가능 여부에 따라 볼륨으로 제한합니다.

사용 가능한 값은 다음과 같습니다.
  • "epub" - epub이 포함된 모든 볼륨
filter string 검색 결과를 필터링합니다.

허용되는 값은 다음과 같습니다.
  • 'ebooks' - 모든 Google eBook
  • 'free-ebooks' - 전체 볼륨 텍스트 가시성이 있는 Google eBook
  • 'full' - 모든 사용자가 전체 볼륨 텍스트를 볼 수 있습니다.
  • 'paid-ebooks' - 가격이 표시된 Google eBook
  • 'partial' - 모든 사용자가 텍스트의 일부를 볼 수 있습니다.
langRestrict string 이 언어 코드가 있는 도서로 결과를 제한합니다.
libraryRestrict string 이 사용자의 라이브러리로 검색 제한

허용되는 값은 다음과 같습니다.
  • 'my-library' - 사용자의 보관함, 모든 섹션으로 제한합니다.
  • "no-restrict" - 사용자 라이브러리를 기반으로 제한하지 않습니다.
maxResults unsigned integer 반환할 결과의 최대 수입니다. 사용 가능한 값: 0~40.
orderBy string 검색 결과 정렬

허용되는 값은 다음과 같습니다.
  • 'newest' - 가장 최근에 게시되었습니다.
  • "relevance" - 검색어와의 관련성
partner string 파트너 ID의 결과를 제한하고 브랜딩합니다.
printType string 도서 또는 잡지로 제한됩니다.

허용되는 값은 다음과 같습니다.
  • 'all' - 모든 볼륨 콘텐츠 유형입니다.
  • 'books' - 도서만
  • "magazines" - 잡지만
projection string 선택한 필드 집합으로 반환되는 정보를 제한합니다.

허용되는 값은 다음과 같습니다.
  • 'full': 모든 볼륨 데이터를 포함합니다.
  • 'lite': volumeInfo 및 accessInfo의 필드 하위 집합을 포함합니다.
showPreorders boolean 선주문 가능한 도서를 표시하려면 true로 설정합니다. 기본값은 false입니다.
source string 이 요청의 출처를 식별하는 문자열입니다.
startIndex unsigned integer 반환할 첫 번째 결과의 색인입니다 (0부터 시작).

요청 본문

이 메소드를 사용할 때는 요청 본문을 제공하지 마세요.

응답

요청에 성공할 경우 이 메소드는 다음과 같은 구조의 응답 본문을 반환합니다.

{
  "kind": "books#volumes",
  "items": [
    volume Resource
  ],
  "totalItems": (value)
}
속성 이름 값 설명 참고
kind string 리소스 유형입니다.
items[] list 볼륨 목록입니다.
totalItems integer 발견된 볼륨의 총 개수입니다. 이 값은 결과를 페이지로 나눈 경우 이 응답에서 반환된 볼륨 수보다 클 수 있습니다.

사용해 보기

아래 익스플로러를 사용하여 라이브 데이터에서 이 메서드를 호출하고 응답을 확인해 보세요.