볼륨: 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 찾은 총 볼륨 수입니다. 이는 페이지로 나눈 경우 이 응답에서 반환된 볼륨의 수보다 클 수 있습니다.

사용해 보기는

아래 탐색기를 사용하여 실시간 데이터에서 이 메서드를 호출하고 응답을 확인하세요.