数据量

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 卷的资源类型。（在 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 和 OTHER。
volumeInfo.industryIdentifiers[].identifier string 行业特定的卷标识符。
volumeInfo.pageCount integer 网页总数。
volumeInfo.dimensions object 此卷的实际尺寸。
volumeInfo.dimensions.height string 此卷的高度或长度（以厘米为单位）。
volumeInfo.dimensions.width string 此卷的宽度（以厘米为单位）。
volumeInfo.dimensions.thickness string 此体积的厚度（以厘米为单位）。
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 本卷的最佳语言（基于内容）。由两个字母组成的 ISO 639-1 代码，如“fr”、“en”等。
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 电子书店中销售或免费提供。可能的值包括 FOR_SALE、FREE、NOT_FOR_SALE 或 FOR_PREORDER。
saleInfo.isEbook boolean 此卷是否为电子书（可以添加到“我的电子书”书架）。
saleInfo.listPrice object 建议零售价。（在 LITE 投影中）
saleInfo.listPrice.amount double 金额（采用下列币种）。（在 LITE 投影中。）
saleInfo.listPrice.currencyCode string ISO 4217 货币代码，由三个字母组成。（在 LITE 投影中。）
saleInfo.retailPrice object 图书的实际销售价格。除非此数量有优惠或折扣，否则此价格与建议零售价或定价相同。（在 LITE 投影中）
saleInfo.retailPrice.amount double 金额（采用下列币种）。（在 LITE 投影中。）
saleInfo.retailPrice.currencyCode string ISO 4217 货币代码，由三个字母组成。（在 LITE 投影中。）
accessInfo object 与阅读或获取该卷文本相关的卷的任何信息。此信息可能因国家/地区而异（例如，图书在某个国家/地区可能属于公共领域，但在另一个国家/地区则不行）。
accessInfo.country string 此访问信息有效的双字母 ISO_3166-1 国家/地区代码。（在 LITE 投影中。）
accessInfo.viewability string 对卷的读取权限。可能的值包括 PARTIAL、ALL_PAGES、NO_PAGES 或 UNKNOWN。该值取决于上面列出的国家/地区。值 PARTIAL 表示发布商允许公开查看部分卷，无需购买。这适用于电子书和非电子书。公共领域图书的值始终为 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 包含搜索查询的文本片段。