卷：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 返回的结果数上限。 可接受的值为 0 到 40（含）。
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 找到的卷总数。如果结果已分页，此值可能会大于此响应中返回的卷数。

试试看！

使用下面的 Explorer 对实际数据调用此方法，然后查看响应。