Bookshelf:list
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
為指定使用者擷取公開的書櫃資源清單。立即試用。
如要進一步瞭解 User-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,針對即時資料呼叫這個方法,然後查看回應。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-11-08 (世界標準時間)。
[null,null,["上次更新時間: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."]]