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 特定版本的卷资源的不透明标识符。（在精简投影模式下）
volumeInfo object 一般音量信息。
volumeInfo.title string 卷名。（采用精简版投影）。
volumeInfo.subtitle string 卷副标题。（采用精简版投影）。
volumeInfo.authors[] list 本卷的作者和/或编辑者的姓名。（在精简投影模式下）
volumeInfo.publisher string 此卷的出版商。（采用精简版投影）。
volumeInfo.publishedDate string 发布日期。（采用精简版投影）。
volumeInfo.description string 卷的摘要。说明文本采用 HTML 格式，并包含简单的格式元素，例如 b、i 和 br 标记。（在精简版投影中）
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 卷内容（文字和图片）版本的标识符。（在精简投影模式下）
volumeInfo.imageLinks.thumbnail string 缩略图大小的图片链接（宽度约为 128 像素）。（在精简版投影中）
volumeInfo.imageLinks.small string 小尺寸（宽度约为 300 像素）的图片链接。（在精简版投影中）
volumeInfo.imageLinks.medium string 中等尺寸（宽度约为 575 像素）的图片链接。（在精简版投影中）
volumeInfo.imageLinks.large string 大尺寸图片链接（宽度约为 800 像素）。（在精简版投影中）
volumeInfo.imageLinks.smallThumbnail string 适用于小尺寸缩略图（宽度约为 80 像素）的图片链接。（在精简版投影中）
volumeInfo.imageLinks.extraLarge string 超大尺寸（宽度约为 1280 像素）的图片链接。（在精简版投影中）
volumeInfo.language string 此卷的最佳语言（基于内容）。它是 ISO 639-1 双字母代码，例如“fr”“en”等。
volumeInfo.mainCategory string 此卷书所属的主要类别。它将是下方返回的类别列表中权重最高的类别。
userInfo object 与此卷相关的用户专用信息。（例如，用户上次阅读的页面或他们是否购买了此图书）
userInfo.review nested object 此用户对此卷的评价（如果有）。
userInfo.readingPosition readingPosition Resource 用户在图书中的当前阅读位置（如果有）。（采用精简版投影）。
userInfo.isPurchased boolean 发出请求的经过身份验证的用户是否购买了此音频内容。（采用精简版投影）。
saleInfo object 与电子书商店和/或购买情况相关的图书的任何信息。此信息可能取决于请求的来源国家/地区（例如，图书可能未在某些国家/地区销售）。
saleInfo.country string 此促销信息适用的 ISO_3166-1 双字母国家/地区代码。（采用精简版投影）。
saleInfo.saleability string 此图书是否在上述国家/地区的 Google 电子书商店中以售或免费提供。可能的值为 FOR_SALE、FREE、NOT_FOR_SALE 或 FOR_PREORDER。
saleInfo.isEbook boolean 此卷是否为电子书（可添加到“我的电子书”书架）。
saleInfo.listPrice object 建议零售价。（在精简版投影中）
saleInfo.listPrice.amount double 金额（以下列币种表示）。（采用精简版投影）。
saleInfo.listPrice.currencyCode string 符合 ISO 4217 标准、由 3 个字母组成的货币代码。（采用精简版投影）。
saleInfo.retailPrice object 图书的实际销售价格。除非此批量有优惠或折扣，否则此价格与建议零售价或定价相同。（在精简版投影中）
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，则表示发布商允许用户在无需购买的情况下公开观看部分内容。这适用于电子书和非电子书。公共领域图书的值始终为 ALL_PAGES。
accessInfo.epub object ePub 内容的相关信息。（在精简版投影中）
accessInfo.pdf object PDF 内容的相关信息。（在精简版投影中）
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 正常 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 包含搜索查询的文本摘要。