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 特定版本的卷资源的不透明标识符。（在 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.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 此卷书所属的主要类别。它将是下方返回的类别列表中权重最高的类别。
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 投影中。）
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。（在 LITE 投影中。）
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 文件，可公开获取或出售。（在 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 包含搜索查询的文本片段。