Volume

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 볼륨 제목입니다. (LITE 프로젝션에서)
volumeInfo.subtitle string 볼륨 부제목 (LITE 프로젝션에서)
volumeInfo.authors[] list 이 볼륨의 저자 또는 편집자의 이름입니다. (LITE 프로젝션)
volumeInfo.publisher string 이 볼륨의 게시자입니다. (라이트 프로젝션)
volumeInfo.publishedDate string 게시일입니다. (LITE 프로젝션에서)
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 국가 코드입니다. (LITE 프로젝션에서)
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 검색어가 포함된 텍스트 스니펫입니다.