音量:list

执行图书搜索。 立即尝试

请求

HTTP 请求

GET https://www.googleapis.com/books/v1/volumes?q={search terms}

参数

参数名称 说明
必需参数
q string 全文搜索查询字符串。
可选参数
download string 根据可下载可用性设置音量限制。

可接受的值:
  • epub”- 含 epub 的所有卷。
filter string 过滤搜索结果。

可接受的值:
  • ebooks”- 所有 Google 电子书。
  • free-ebooks”- 全文文本可见度的 Google 电子书。
  • full”- 公开可以查看所有卷文本。
  • paid-ebooks”- 包含价格的 Google 电子书。
  • partial”- 公众可以看到部分文本。
langRestrict string 将搜索结果限制为采用此语言代码的图书。
libraryRestrict string 将搜索范围限制到此用户的内容库。

可接受的值:
  • my-library”- 仅限用户媒体库中的任何书架。
  • no-restrict”- 请勿根据用户的库进行限制。
maxResults unsigned integer 要返回的结果数上限。可接受的值为 040(含)。
orderBy string 对搜索结果进行排序。

可接受的值:
  • newest”- 最近发布。
  • relevance”- 与搜索字词的相关性。
partner string 限制和标识合作伙伴 ID 的结果。
printType string 仅限图书或杂志。

可接受的值:
  • all”- 所有音量内容类型。
  • books”- 仅图书。
  • magazines”- 仅杂志。
projection string 限制返回一组选定字段的信息。

可接受的值:
  • full”- 包括所有音量数据。
  • lite”- 包含 volumeInfo 和 accessInfo 中的部分字段。
showPreorders boolean 设置为 true 可显示可供预订的图书。默认值为 false。
source string 用于标识此请求发起方的字符串。
startIndex unsigned integer 要返回的第一个结果的索引(从 0 开始)

请求正文

使用此方法时请勿提供请求正文。

响应

如果成功,此方法将返回采用以下结构的响应正文:

{
  "kind": "books#volumes",
  "items": [
    volume Resource
  ],
  "totalItems": (value)
}
物业名称 说明 备注
kind string 资源类型。
items[] list 卷列表。
totalItems integer 找到的卷总数。如果结果已分页,此值可能会大于此响应中返回的卷数。

试试看!

请使用下面的浏览器对实时数据调用此方法,然后查看响应。