볼륨: 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로 설정하세요. 기본값은 거짓입니다.
source string 이 요청의 작성자를 식별하는 문자열입니다.
startIndex unsigned integer 반환할 첫 번째 결과의 색인 (0에서 시작)

요청 본문

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

응답

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

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

사용해 보기

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