此页面由 Cloud Translation API 翻译。

Volume

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`	卷的资源类型。（采用精简版投影。）
`id`	`string`	卷的唯一标识符。（采用精简版投影）。
`etag`	`string`	特定版本的卷资源的不透明标识符。（在 LITE 投影中）
`selfLink`	`string`	指向此资源的网址。（在 LITE 投影中。）
`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`	卷内容（文字和图片）版本的标识符。（在 LITE 投影中）
`volumeInfo.imageLinks`	`object`	所有可用尺寸的图片链接列表。（在精简版投影中）
`volumeInfo.imageLinks.thumbnail`	`string`	缩略图大小的图片链接（宽度约为 128 像素）。（在精简版投影中）
`volumeInfo.imageLinks.small`	`string`	小尺寸（宽度约为 300 像素）的图片链接。（在精简版投影中）
`volumeInfo.imageLinks.medium`	`string`	中等尺寸（宽度约为 575 像素）的图片链接。（在 LITE 投影中）
`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`	此卷书所属的主要类别。它将是下方返回的类别列表中权重最高的类别。
`volumeInfo.previewLink`	`string`	用于在 Google 图书网站上预览此卷的网址。
`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`	建议零售价。（在 LITE 投影中）
`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 个字母组成的货币代码。（在 LITE 投影中。）
`saleInfo.buyLink`	`string`	在 Google 图书网站上购买此卷的网址。（在精简版投影中）
`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.epub.downloadLink`	`string`	用于下载 ePub 的网址。（在 LITE 投影中。）
`accessInfo.epub.acsTokenLink`	`string`	用于检索 ACS 令牌以下载 ePub 的网址。（在 LITE 投影中。）
`accessInfo.pdf`	`object`	有关 PDF 内容的信息。（在精简版投影中）
`accessInfo.pdf.downloadLink`	`string`	用于下载 PDF 的网址。（采用精简版投影）。
`accessInfo.pdf.acsTokenLink`	`string`	用于检索 ACS 令牌以下载 PDF 文件的网址。（采用精简版投影）。
`accessInfo.accessViewStatus`	`string`	将此卷的访问权限和可见度合并到该用户的单个状态字段中。值可以是 FULL_PURCHASED、FULL_PUBLIC_DOMAIN、SAMPLE 或 NONE。（在 LITE 投影中。）
`accessInfo.embeddable`	`boolean`	此卷是否可以使用 Embedded Viewer API 嵌入到视口中。
`accessInfo.publicDomain`	`boolean`	此图书在上述国家/地区是否属于公共领域。
`volumeInfo.infoLink`	`string`	用于在 Google 图书网站上查看此卷信息的网址。（在精简投影模式下）
`userInfo.updated`	`datetime`	此卷次上次因用户操作（例如更新阅读位置、购买卷次或撰写评价）而被修改的时间戳。（RFC 3339 UTC 日期时间格式）。
`volumeInfo.canonicalVolumeLink`	`string`	卷的规范网址。（采用精简版投影。）
`userInfo.isPreordered`	`boolean`	发出请求的经过身份验证的用户是否预订了此卷。（采用精简版投影）。
`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 图书网站上阅读此卷的网址。链接不允许用户阅读无法观看的卷。
`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`	包含搜索查询的文本片段。