Bookshelf: get
Stay organized with collections
Save and categorize content based on your preferences.
Retrieves a specific 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/shelf
Parameters
| Parameter Name |
Value |
Description |
| Required Parameters |
shelf |
string |
ID of bookshelf to retrieve.
|
userId |
string |
ID of user for whom to retrieve bookshelves.
|
| Optional Parameters |
source |
string |
String to identify the originator of this request.
|
Request Body
Do not supply a request body with this method.
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.
[null,null,["Last updated 2024-06-26 UTC."],[[["\u003cp\u003eRetrieves a specific bookshelf resource for a given user using their user ID and bookshelf ID.\u003c/p\u003e\n"],["\u003cp\u003eRequest parameters include the bookshelf ID (\u003ccode\u003eshelf\u003c/code\u003e), the user ID (\u003ccode\u003euserId\u003c/code\u003e), and an optional source parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe request should be a GET request to the specified URL with the parameters provided.\u003c/p\u003e\n"],["\u003cp\u003eA successful response returns a Bookshelf resource with information about the requested bookshelf.\u003c/p\u003e\n"],["\u003cp\u003eNo request body is needed for this method.\u003c/p\u003e\n"]]],[],null,["# Bookshelf: get\n\nRetrieves a specific [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/shelf\n```\n\n### Parameters\n\n| Parameter Name | Value | Description |\n|----------------|----------|----------------------------------------------------|\n| **Required Parameters** |||\n| `shelf` | `string` | ID of bookshelf to retrieve. |\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 [Bookshelf resource](/books/docs/v1/reference/bookshelves#resource) in the response body.\n\nTry It!\n-------\n\n\nUse the explorer below to call this method on live data and see the response."]]