볼륨

Volume 컬렉션은 보관함의 콘텐츠를 검색하거나 나열하는 데 사용됩니다. 이 컬렉션은 읽기 전용 컬렉션입니다.

메서드

다음 메서드는 볼륨에 관한 공개 데이터에 적용되며 인증이 필요하지 않습니다.
books.volumes.list
books.volumes.get

다음 메서드는 볼륨의 비공개 '내 라이브러리' 뷰에 적용되며 인증이 필요합니다.
books.mylibrary.bookshelves.volumes.list

get
ID를 기반으로 볼륨 리소스를 검색합니다.
list
도서 검색을 실행합니다.

리소스 표현

볼륨은 Google 북에서 도서 또는 잡지에 관해 호스팅하는 정보를 나타냅니다. 제목 및 저자와 같은 메타데이터와 구매 여부와 같은 맞춤설정 데이터가 포함됩니다. LITE 프로젝션에서 사용할 수 있는 볼륨 필드는 아래에 나와 있습니다.

{
  "kind": "books#volume",
  "id": string,
  "etag": string,
  "selfLink": string,
  "volumeInfo": {
    "title": string,
    "subtitle": string,
    "authors": [
      string
    ],
    "publisher": string,
    "publishedDate": string,
    "description": string,
    "industryIdentifiers": [
      {
        "type": string,
        "identifier": string
      }
    ],
    "pageCount": integer,
    "dimensions": {
      "height": string,
      "width": string,
      "thickness": string
    },
    "printType": string,
    "mainCategory": string,
    "categories": [
      string
    ],
    "averageRating": double,
    "ratingsCount": integer,
    "contentVersion": string,
    "imageLinks": {
      "smallThumbnail": string,
      "thumbnail": string,
      "small": string,
      "medium": string,
      "large": string,
      "extraLarge": string
    },
    "language": string,
    "previewLink": string,
    "infoLink": string,
    "canonicalVolumeLink": string
  },
  "userInfo": {
    "review": mylibrary.reviews Resource,
    "readingPosition": mylibrary.readingpositions Resource,
    "isPurchased": boolean,
    "isPreordered": boolean,
    "updated": datetime
  },
  "saleInfo": {
    "country": string,
    "saleability": string,
    "onSaleDate": datetime,
    "isEbook": boolean,
    "listPrice": {
      "amount": double,
      "currencyCode": string
    },
    "retailPrice": {
      "amount": double,
      "currencyCode": string
    },
    "buyLink": string
  },
  "accessInfo": {
    "country": string,
    "viewability": string,
    "embeddable": boolean,
    "publicDomain": boolean,
    "textToSpeechPermission": string,
    "epub": {
      "isAvailable": boolean,
      "downloadLink": string,
      "acsTokenLink": string
    },
    "pdf": {
      "isAvailable": boolean,
      "downloadLink": string,
      "acsTokenLink": string
    },
    "webReaderLink": string,
    "accessViewStatus": string,
    "downloadAccess": {
      "kind": "books#downloadAccessRestriction",
      "volumeId": string,
      "restricted": boolean,
      "deviceAllowed": boolean,
      "justAcquired": boolean,
      "maxDownloadDevices": integer,
      "downloadsAcquired": integer,
      "nonce": string,
      "source": string,
      "reasonCode": string,
      "message": string,
      "signature": string
    }
  },
  "searchInfo": {
    "textSnippet": string
  }
}
속성 이름 값 설명 참고
kind string 볼륨의 리소스 유형입니다. (라이트 프로젝션)
id string 볼륨의 고유 식별자입니다. (라이트 프로젝션)
etag string 볼륨 리소스의 특정 버전에 대한 불투명 식별자입니다. (LITE 프로젝션)
volumeInfo object 일반적인 볼륨 정보입니다.
volumeInfo.title string 볼륨 제목입니다. (라이트 프로젝션)
volumeInfo.subtitle string 볼륨 자막 (라이트 프로젝션)
volumeInfo.authors[] list 이 볼륨의 저자 또는 편집자의 이름입니다. (LITE 프로젝션)
volumeInfo.publisher string 이 볼륨의 게시자입니다. (라이트 프로젝션)
volumeInfo.publishedDate string 게시일입니다. (라이트 프로젝션)
volumeInfo.description string 볼륨의 개요입니다. 설명 텍스트는 HTML 형식으로 지정되며 b, i, br 태그와 같은 간단한 형식 지정 요소가 포함됩니다. (LITE 프로젝션)
volumeInfo.industryIdentifiers[] list 이 볼륨의 업계 표준 식별자입니다.
volumeInfo.industryIdentifiers[].type string 식별자 유형입니다. 가능한 값은 ISBN_10, ISBN_13, ISSN, OTHER입니다.
volumeInfo.industryIdentifiers[].identifier string 업계별 볼륨 식별자입니다.
volumeInfo.pageCount integer 총 페이지 수입니다.
volumeInfo.dimensions object 이 볼륨의 실제 크기입니다.
volumeInfo.dimensions.height string 이 볼륨의 높이 또는 길이 (cm)입니다.
volumeInfo.dimensions.width string 이 볼륨의 너비입니다 (cm).
volumeInfo.dimensions.thickness string 이 볼륨의 두께 (cm)입니다.
volumeInfo.printType string 이 볼륨의 출판 유형입니다. 가능한 값은 BOOK 또는 MAGAZINE입니다.
volumeInfo.categories[] list '소설', '스릴러'와 같은 주제 카테고리 목록입니다.
volumeInfo.averageRating double 이 볼륨의 평균 리뷰 평점입니다. (min = 1.0, max = 5.0)
volumeInfo.ratingsCount integer 이 볼륨에 대한 리뷰 평점 수입니다.
volumeInfo.contentVersion string 볼륨 콘텐츠 (텍스트 및 이미지) 버전의 식별자입니다. (LITE 프로젝션)
volumeInfo.imageLinks.thumbnail string 썸네일 크기 (너비 약 128픽셀)의 이미지 링크입니다. (LITE 프로젝션)
volumeInfo.imageLinks.small string 소형 (너비 약 300픽셀) 이미지 링크입니다. (LITE 프로젝션)
volumeInfo.imageLinks.medium string 중간 크기 (너비 약 575픽셀)의 이미지 링크입니다. (LITE 프로젝션)
volumeInfo.imageLinks.large string 대형 (너비 약 800픽셀) 이미지 링크입니다. (LITE 프로젝션)
volumeInfo.imageLinks.smallThumbnail string 작은 썸네일 크기 (너비 약 80픽셀)의 이미지 링크입니다. (LITE 프로젝션)
volumeInfo.imageLinks.extraLarge string 초대형 크기 (너비 약 1280픽셀)의 이미지 링크입니다. (LITE 프로젝션)
volumeInfo.language string 이 볼륨에 가장 적합한 언어 (콘텐츠에 따라 다름)입니다. 'fr', 'en' 등과 같은 두 글자 ISO 639-1 코드입니다.
volumeInfo.mainCategory string 이 볼륨이 속한 기본 카테고리입니다. 아래에 반환된 카테고리 목록에서 가중치가 가장 높은 카테고리입니다.
userInfo object 이 볼륨과 관련된 사용자별 정보입니다. (예: 사용자가 마지막으로 읽은 페이지 또는 이 책을 구매했는지 여부)
userInfo.review nested object 이 사용자가 이 볼륨에 대해 작성한 리뷰입니다(있는 경우).
userInfo.readingPosition readingPosition Resource 볼륨에서 사용자의 현재 읽기 위치입니다(사용 가능한 경우). (라이트 프로젝션)
userInfo.isPurchased boolean 요청을 한 인증된 사용자가 이 볼륨을 구매했는지 여부입니다. (라이트 프로젝션)
saleInfo object eBook 스토어 또는 구매 가능 여부와 관련된 볼륨에 관한 모든 정보 이 정보는 요청이 발생한 국가에 따라 다를 수 있습니다 (예: 특정 국가에서는 도서를 판매할 수 없음).
saleInfo.country string 이 할인 정보가 유효한 두 자리 ISO_3166-1 국가 코드입니다. (라이트 프로젝션)
saleInfo.saleability string 위에 나열된 국가의 Google eBookstore에서 이 도서를 판매할 수 있는지 또는 무료로 제공되는지 여부입니다. 가능한 값은 FOR_SALE, FREE, NOT_FOR_SALE, FOR_PREORDER입니다.
saleInfo.isEbook boolean 이 볼륨이 eBook인지 여부 (내 eBook 섹션에 추가할 수 있음)
saleInfo.listPrice object 권장 소매가입니다. (LITE 프로젝션)
saleInfo.listPrice.amount double 아래에 나열된 통화로 표시된 금액입니다. (라이트 프로젝션)
saleInfo.listPrice.currencyCode string ISO 4217 3자리 통화 코드입니다. (라이트 프로젝션)
saleInfo.retailPrice object 도서의 실제 판매가입니다. 이 수량에 대한 혜택이나 할인이 없는 한 권장 소매가 또는 정가와 동일합니다. (LITE 프로젝션)
saleInfo.retailPrice.amount double 아래에 나열된 통화로 표시된 금액입니다. (라이트 프로젝션)
saleInfo.retailPrice.currencyCode string ISO 4217 3자리 통화 코드입니다. (라이트 프로젝션)
accessInfo object 볼륨 텍스트를 읽거나 가져오는 것과 관련된 볼륨에 관한 정보입니다. 이 정보는 국가에 따라 다를 수 있습니다 (예: 한 국가에서는 도서가 공개 도메인이지만 다른 국가에서는 공개 도메인이 아닐 수 있음).
accessInfo.country string 이 액세스 정보가 유효한 두 자리 ISO_3166-1 국가 코드입니다. (라이트 프로젝션)
accessInfo.viewability string 볼륨의 읽기 액세스 권한입니다. 가능한 값은 PARTIAL, ALL_PAGES, NO_PAGES 또는 UNKNOWN입니다. 이 값은 위에 나열된 국가에 따라 다릅니다. 값이 PARTIAL이면 게시자가 구매 없이 볼륨의 일부를 공개적으로 볼 수 있도록 허용한 것입니다. 이는 eBook뿐만 아니라 eBook이 아닌 항목에도 적용될 수 있습니다. 공공 도서관의 도서는 항상 ALL_PAGES 값을 갖습니다.
accessInfo.epub object epub 콘텐츠에 관한 정보입니다. (LITE 프로젝션)
accessInfo.pdf object PDF 콘텐츠에 관한 정보입니다. (LITE 프로젝션)
accessInfo.accessViewStatus string 이 볼륨의 액세스 가능성과 조회가능성을 이 사용자의 단일 상태 필드로 결합합니다. 값은 FULL_PURCHASED, FULL_PUBLIC_DOMAIN, SAMPLE 또는 NONE일 수 있습니다. (라이트 프로젝션)
accessInfo.embeddable boolean Embedded Viewer API를 사용하여 이 볼륨을 뷰포트에 삽입할 수 있는지 여부입니다.
accessInfo.publicDomain boolean 위에 나열된 국가에서 이 책의 저작권이 소멸되었는지 여부입니다.
userInfo.updated datetime 읽기 위치 업데이트, 볼륨 구매 또는 리뷰 작성과 같은 사용자 작업으로 이 볼륨이 마지막으로 수정된 타임스탬프입니다. (RFC 3339 UTC 날짜-시간 형식)
userInfo.isPreordered boolean 요청을 한 인증된 사용자가 이 볼륨을 선주문했는지 여부입니다. (라이트 프로젝션)
saleInfo.onSaleDate datetime 이 책을 판매할 수 있는 날짜입니다.
accessInfo.textToSpeechPermission string 이 볼륨에 텍스트 음성 변환이 허용되는지 여부입니다. 값은 ALLOWED, ALLOWED_FOR_ACCESSIBILITY, NOT_ALLOWED 중 하나일 수 있습니다.
accessInfo.epub.isAvailable boolean 흐르는 텍스트 epub가 공개 도메인으로 제공되거나 구매할 수 있는지 여부입니다. (라이트 프로젝션)
accessInfo.pdf.isAvailable boolean 스캔한 이미지 PDF를 공개 도메인으로 제공하거나 구매할 수 있는지 여부입니다. (라이트 프로젝션)
accessInfo.downloadAccess nested object 볼륨의 다운로드 라이선스 액세스 제한에 관한 정보입니다.
accessInfo.downloadAccess.kind string 리소스 유형입니다.
accessInfo.downloadAccess.volumeId string 이 항목이 적용되는 볼륨을 식별합니다.
accessInfo.downloadAccess.restricted boolean 이 볼륨에 다운로드 액세스 제한이 있는지 여부입니다.
accessInfo.downloadAccess.deviceAllowed boolean 제한된 경우 이 항목 (사용자, 기기, 볼륨)에 대한 액세스 권한이 부여되었는지 여부입니다.
accessInfo.downloadAccess.justAcquired boolean deviceAllowed인 경우 이 요청으로 액세스 권한을 획득했는지 여부입니다.
accessInfo.downloadAccess.maxDownloadDevices integer 제한된 경우 이 볼륨의 콘텐츠 다운로드 라이선스 최대 개수입니다.
accessInfo.downloadAccess.downloadsAcquired integer 제한된 경우 이미 획득한 콘텐츠 다운로드 라이선스 수입니다 (라이선스가 있는 경우 요청하는 클라이언트 포함).
accessInfo.downloadAccess.nonce string 인증을 위한 클라이언트 nonce입니다. 다운로드 액세스 및 클라이언트 유효성 검사만 가능합니다.
accessInfo.downloadAccess.source string 인증을 위한 클라이언트 앱 식별자입니다. 다운로드 액세스 및 클라이언트 유효성 검사만.
accessInfo.downloadAccess.reasonCode string 오류/경고 이유 코드 향후 추가 코드가 추가될 수 있습니다. 0 OK 100 ACCESS_DENIED_PUBLISHER_LIMIT 101 ACCESS_DENIED_LIMIT 200 WARNING_USED_LAST_ACCESS
accessInfo.downloadAccess.message string 오류/경고 메시지
accessInfo.downloadAccess.signature string 응답 서명
searchInfo object 이 볼륨과 관련된 검색 결과 정보입니다.
searchInfo.textSnippet string 검색어를 포함하는 텍스트 스니펫