检索指定用户特定书架中的图书。 立即试用。
请求
HTTP 请求
GET https://www.googleapis.com/books/v1/users/userId/bookshelves/shelf/volumes
参数
参数名称 | 值 | 说明 |
---|---|---|
必需参数 | ||
shelf |
string |
要检索图书的书架的 ID。 |
userId |
string |
要为其检索书架图书的用户的 ID。 |
可选参数 | ||
maxResults |
unsigned integer |
返回的结果数上限 |
showPreorders |
boolean |
设为 true 即可显示预订的图书。默认值为 false。 |
source |
string |
用于标识此请求发起者的字符串。 |
startIndex |
unsigned integer |
要返回的第一个元素的索引(从 0 开始) |
请求正文
使用此方法时请勿提供请求正文。
响应
如果成功,此方法将返回以下结构的响应正文:
{ "kind": "books#volumes", "totalItems": integer, "items": [ volumes Resource ] }
属性名称 | 值 | 说明 | 备注 |
---|---|---|---|
kind |
string |
资源类型。 | |
totalItems |
integer |
找到的卷总数。如果结果已分页,此值可能会大于此响应中返回的卷数。 | |
items[] |
list |
卷列表。 |
试试看!
使用下面的 Explorer 对实际数据调用此方法,然后查看响应。