执行图书搜索。 立即尝试。
请求
HTTP 请求
GET https://www.googleapis.com/books/v1/volumes?q={search terms}
参数
参数名称 | 值 | 说明 |
---|---|---|
必需参数 | ||
q |
string |
全文搜索查询字符串。 |
可选参数 | ||
download |
string |
根据下载内容的可用性限制卷。
可接受的值:
|
filter |
string |
过滤搜索结果。
可接受的值:
|
langRestrict |
string |
将结果限制为使用此语言代码的图书。 |
libraryRestrict |
string |
将搜索范围限制在此用户的书库中。
可接受的值:
|
maxResults |
unsigned integer |
返回的结果数上限。
可接受的值包括 0 到 40 (闭区间)。
|
orderBy |
string |
对搜索结果进行排序。
可接受的值:
|
partner |
string |
对合作伙伴 ID 进行限制和品牌搜索结果。 |
printType |
string |
仅限于图书或杂志。
可接受的值:
|
projection |
string |
限制仅返回一组所选字段的信息。
可接受的值:
|
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 针对实时数据调用此方法并查看响应。