书架:list
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
检索指定用户的公开书架资源列表。
立即试用。
如需详细了解用户 ID,请参阅 Google 图书 ID 部分。
请求
HTTP 请求
GET https://www.googleapis.com/books/v1/users/userId/bookshelves
参数
参数名称 |
值 |
说明 |
必需参数 |
userId |
string |
要为其检索书架的用户的 ID。
|
可选参数 |
source |
string |
用于标识此请求发起者的字符串。
|
请求正文
使用此方法时请勿提供请求正文。
响应
如果成功,此方法将返回以下结构的响应正文:
{
"kind": "books#bookshelves",
"items": [
bookshelf Resource
]
}
属性名称 |
值 |
说明 |
备注 |
kind |
string |
资源类型。 |
|
items[] |
list |
书架列表。 |
|
试试看!
请使用下面的 Explorer 针对实时数据调用此方法并查看响应。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-11-08。
[null,null,["最后更新时间 (UTC):2024-11-08。"],[[["\u003cp\u003eRetrieves a list of public bookshelves for a specific user ID.\u003c/p\u003e\n"],["\u003cp\u003eRequest requires the user ID and can optionally include the request source.\u003c/p\u003e\n"],["\u003cp\u003eResponse includes resource type and a list of bookshelves if successful.\u003c/p\u003e\n"],["\u003cp\u003eMethod does not require a request body.\u003c/p\u003e\n"],["\u003cp\u003eUsers can try the method with live data using the provided explorer.\u003c/p\u003e\n"]]],[],null,["# Bookshelf: list\n\nRetrieves a list of public [Bookshelf resource](/books/docs/v1/reference/bookshelves) for the specified user.\n[Try it now](#try-it).\n\nMore information about user IDs can be found in the section [Google Books IDs](/books/docs/v1/using#ids).\n\nRequest\n-------\n\n### HTTP Request\n\n```\nGET https://www.googleapis.com/books/v1/users/userId/bookshelves\n```\n\n### Parameters\n\n| Parameter Name | Value | Description |\n|----------------|----------|----------------------------------------------------|\n| **Required Parameters** |||\n| `userId` | `string` | ID of user for whom to retrieve bookshelves. |\n| **Optional Parameters** |||\n| `source` | `string` | String to identify the originator of this request. |\n\n### Request Body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```objective-c\n{\n \"kind\": \"books#bookshelves\",\n \"items\": [\n bookshelf Resource\n ]\n}\n```\n\n| Property Name | Value | Description | Notes |\n|---------------|----------|------------------------|-------|\n| `kind` | `string` | Resource type. | |\n| `items[]` | `list` | A list of bookshelves. | |\n\nTry It!\n-------\n\n\nUse the explorer below to call this method on live data and see the response."]]