卷：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 对实际数据调用此方法，然后查看响应。