卷：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 针对实时数据调用此方法并查看响应。