Bookshelf: list
Stay organized with collections
Save and categorize content based on your preferences.
Retrieves a list of public Bookshelf resource
for the specified user. Try it now
.
More information about user IDs can be found in the section Google Books IDs
.
Request
HTTP Request
GET https://www.googleapis.com/books/v1/users/ userId
/bookshelves
Parameters
Parameter Name
Value
Description
userId
string
ID of user for whom to retrieve bookshelves.
source
string
String to identify the originator of this request.
Request Body
Do not supply a request body with this method.
Response
If successful, this method returns a response body with the following structure:
Try It!
Use the explorer below to call this method on live data and see the response.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License
, and code samples are licensed under the Apache 2.0 License
. For details, see the Google Developers Site Policies
. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-06-26 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-06-26 UTC."],[[["\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."]]
