음량

Volume 컬렉션은 서가의 콘텐츠를 검색하거나 목록을 표시하는 데 사용됩니다. 이 컬렉션은 읽기 전용 컬렉션입니다.

방법

다음 방법은 볼륨에 대한 공개 데이터에 적용되며 인증이 필요하지 않습니다.
books.volumes.list
books.volumes.get

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

가져오기
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 볼륨의 리소스 유형입니다. (LITE 프로젝션에서)
id string 볼륨의 고유 식별자입니다. (LITE 프로젝션에서)
etag string 볼륨 리소스의 특정 버전에 대한 불투명 식별자입니다. (LITE 프로젝션에서)
volumeInfo object 일반 볼륨 정보입니다.
volumeInfo.title string 볼륨 제목 (LITE 프로젝션에서)
volumeInfo.subtitle string 볼륨 자막 (LITE 프로젝션에서)
volumeInfo.authors[] list 이 권의 저자 또는 편집자 이름. (LITE 프로젝션에서)
volumeInfo.publisher string 이 책의 출판사입니다. (LITE 프로젝션에서)
volumeInfo.publishedDate string 게시 날짜 (LITE 프로젝션에서)
volumeInfo.description string 볼륨의 개요입니다. 설명 텍스트는 HTML 형식으로 되어 있으며 b, i, br 태그와 같은 간단한 서식 요소를 포함합니다. (LITE 프로젝션에서)
volumeInfo.industryIdentifiers[] list 이 볼륨의 업계 표준 식별자입니다.
volumeInfo.industryIdentifiers[].type string 식별자 유형입니다. 가능한 값은 ISBN_10, ISBN_13, ISSN 등입니다.
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 이 볼륨의 평균 리뷰 평점입니다. (최소 = 1.0, 최대 = 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 볼륨에서 사용자의 현재 읽기 위치(사용 가능한 경우) (LITE 프로젝션에서)
userInfo.isPurchased boolean 요청받은 인증된 사용자가 이 도서를 구매했는지 여부입니다. (LITE 프로젝션에서)
saleInfo object 전자책 서점 및/또는 구매 가능성과 관련된 도서 정보 이 정보는 요청이 발생한 국가에 따라 다를 수 있습니다 (예: 특정 국가에서 책을 판매하지 않을 수 있음).
saleInfo.country string 판매 정보가 유효한 두 자리 ISO_3166-1 국가 코드입니다. (LITE 프로젝션에서)
saleInfo.saleability string 위에 나열된 국가의 Google eBook 스토어에서 이 책을 판매하거나 무료로 제공할 수 있습니다. 가능한 값은 FOR_SALE, FREE, NOT_FOR_SALE, FOR_PREORDER입니다.
saleInfo.isEbook boolean 도서가 eBook인지 여부를 나타냅니다 (내 eBook 서가에 추가 가능).
saleInfo.listPrice object 권장 소매가입니다. (LITE 프로젝션에서)
saleInfo.listPrice.amount double 아래에 표시된 통화 금액 (LITE 프로젝션에서)
saleInfo.listPrice.currencyCode string ISO 4217의 3자리 통화 코드입니다. (LITE 프로젝션에서)
saleInfo.retailPrice object 책의 실제 판매가입니다. 이 수량에 쿠폰이나 할인이 없는 한 권장 소매가 또는 정가와 동일합니다. (LITE 프로젝션에서)
saleInfo.retailPrice.amount double 아래에 표시된 통화 금액 (LITE 프로젝션에서)
saleInfo.retailPrice.currencyCode string ISO 4217의 3자리 통화 코드입니다. (LITE 프로젝션에서)
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일 수 있습니다. (LITE 프로젝션에서)
accessInfo.embeddable boolean Embedded Viewer API를 사용하여 이 볼륨을 표시 영역에 삽입할 수 있는지 여부
accessInfo.publicDomain boolean 도서가 위에 나열된 국가의 공개 도메인인지를 나타냅니다.
userInfo.updated datetime 판독 위치 업데이트, 볼륨 구매, 리뷰 작성 등 사용자 작업에 의해 마지막으로 수정된 타임스탬프입니다. (RFC 3339 UTC 날짜-시간 형식).
userInfo.isPreordered boolean 이 볼륨은 요청하는 인증된 사용자가 이 볼륨을 선주문했는지 여부를 나타냅니다. (LITE 프로젝션에서)
saleInfo.onSaleDate datetime 책을 판매할 수 있는 날짜입니다.
accessInfo.textToSpeechPermission string 이 볼륨의 텍스트 음성 변환 허용 여부입니다. 값은 ALLOWED, ALLOWED_FOR_ACCESSIBILITY 또는 NOT_ALLOWED일 수 있습니다.
accessInfo.epub.isAvailable boolean 맞춤 텍스트 epub가 공개 도메인 또는 구매용으로 제공됩니다. (LITE 프로젝션에서)
accessInfo.pdf.isAvailable boolean 스캔한 이미지 pdf는 공개 도메인 또는 구매용인지 여부입니다. (LITE 프로젝션에서)
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 검색어가 포함된 텍스트 스니펫