이 페이지는 Cloud Translation API를 통해 번역되었습니다.

볼륨

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

방법

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

books.volumes.list

books.volumes.get

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

books.mylibrary.bookshelves.volumes.list

books.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`	볼륨의 리소스 유형입니다. (LITE 프로젝션에서)
`id`	`string`	볼륨의 고유 식별자입니다. (LITE 프로젝션에서)
`etag`	`string`	볼륨 리소스의 특정 버전에 대한 불투명 식별자입니다. (LITE 프로젝션)
`selfLink`	`string`	이 리소스의 URL입니다. (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 및 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`	이 권호의 평균 리뷰 평점입니다. (최소 = 1.0, 최대 = 5.0)
`volumeInfo.ratingsCount`	`integer`	이 권호에 대한 리뷰 평점 수입니다.
`volumeInfo.contentVersion`	`string`	볼륨 콘텐츠 (텍스트 및 이미지) 버전의 식별자입니다. (LITE 프로젝션)
`volumeInfo.imageLinks`	`object`	사용 가능한 모든 크기의 이미지 링크 목록입니다. (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`	권이 속하는 기본 카테고리입니다. 아래에 반환된 카테고리 목록의 카테고리 중 가중치가 가장 높은 카테고리가 표시됩니다.
`volumeInfo.previewLink`	`string`	Google 도서 사이트에서 이 볼륨을 미리 볼 수 있는 URL입니다.
`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 전자책 서점에서 이 책이 판매되고 있는지 또는 무료로 제공되는지 여부를 나타냅니다. 가능한 값은 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`	3글자의 ISO 4217 통화 코드입니다. (LITE 프로젝션에서)
`saleInfo.retailPrice`	`object`	책의 실제 판매가입니다. 이 양에 혜택이나 할인이 없는 한 권장 소매가 또는 정가와 동일합니다. (LITE 프로젝션)
`saleInfo.retailPrice.amount`	`double`	아래에 표시된 통화로 표기된 금액 (LITE 프로젝션에서)
`saleInfo.retailPrice.currencyCode`	`string`	3글자의 ISO 4217 통화 코드입니다. (LITE 프로젝션에서)
`saleInfo.buyLink`	`string`	Google 도서 사이트에서 이 볼륨을 구매할 수 있는 URL입니다. (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.epub.downloadLink`	`string`	ePub를 다운로드할 수 있는 URL입니다. (LITE 프로젝션에서)
`accessInfo.epub.acsTokenLink`	`string`	epub 다운로드를 위한 ACS 토큰 검색 URL입니다. (LITE 프로젝션에서)
`accessInfo.pdf`	`object`	PDF 콘텐츠에 관한 정보입니다. (LITE 프로젝션)
`accessInfo.pdf.downloadLink`	`string`	PDF를 다운로드할 수 있는 URL입니다. (LITE 프로젝션에서)
`accessInfo.pdf.acsTokenLink`	`string`	PDF 다운로드를 위해 ACS 토큰을 가져올 URL입니다. (LITE 프로젝션에서)
`accessInfo.accessViewStatus`	`string`	이 볼륨의 액세스 권한 및 조회가능성을 이 사용자의 단일 상태 필드로 결합합니다. 값은 FULL_PURCHASED, FULL_PUBLIC_DOMAIN, samples 또는 NONE일 수 있습니다. (LITE 프로젝션에서)
`accessInfo.embeddable`	`boolean`	Embedded Viewer API를 사용하여 이 볼륨을 표시 영역에 삽입할 수 있는지 여부입니다.
`accessInfo.publicDomain`	`boolean`	도서가 위에 나열된 국가에서 공개 도메인에 속하는지 여부입니다.
`volumeInfo.infoLink`	`string`	Google 도서 사이트에서 이 볼륨에 대한 정보를 볼 수 있는 URL입니다. (LITE 프로젝션)
`userInfo.updated`	`datetime`	읽기 위치 업데이트, 볼륨 구매, 리뷰 쓰기와 같은 사용자 작업에 의해 이 볼륨이 마지막으로 수정된 타임스탬프입니다. (RFC 3339 UTC 날짜-시간 형식).
`volumeInfo.canonicalVolumeLink`	`string`	볼륨의 표준 URL입니다. (LITE 프로젝션에서)
`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.webReaderLink`	`string`	Google 도서 사이트에서 이 볼륨을 읽을 수 있는 URL입니다. 이 링크에서 사용자는 조회 불가능한 볼륨을 읽을 수 없습니다.
`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`	검색어가 포함된 텍스트 스니펫입니다.