# Bookshelf

The `Bookshelf` collection allows you to view bookshelf metadata as well as to modify the contents of a bookshelf.

## Methods

<br />

The following methods apply to the public data about bookshelves and don't require authentication.[books.bookshelves.list](https://developers.google.com/books/docs/v1/reference/bookshelves#method_books_bookshelves_list)[books.bookshelves.get](https://developers.google.com/books/docs/v1/reference/bookshelves#method_books_bookshelves_get)  
The following methods apply to the private, "My Library" view of bookshelves and require authentication.[books.mylibrary.bookshelves.list](https://developers.google.com/books/docs/v1/reference/bookshelves#method_books_mylibrary_bookshelves_list)  
[books.mylibrary.bookshelves.get](https://developers.google.com/books/docs/v1/reference/bookshelves#method_books_mylibrary_bookshelves_get)  
[books.mylibrary.bookshelves.addVolume](https://developers.google.com/books/docs/v1/reference/bookshelves#method_books_mylibrary_bookshelves_addVolume)  
[books.mylibrary.bookshelves.removeVolume](https://developers.google.com/books/docs/v1/reference/bookshelves#method_books_mylibrary_bookshelves_removeVolume)  
[books.mylibrary.bookshelves.clearVolumes](https://developers.google.com/books/docs/v1/reference/bookshelves#method_books_mylibrary_bookshelves_clearVolumes)

<br />

[list](https://developers.google.com/books/docs/v1/reference/bookshelves/list)
:   Retrieves a list of public [Bookshelf resource](https://developers.google.com/books/docs/v1/reference/bookshelves) for the specified user.

[get](https://developers.google.com/books/docs/v1/reference/bookshelves/get)
:   Retrieves a specific [Bookshelf resource](https://developers.google.com/books/docs/v1/reference/bookshelves) for the specified user.

## Resource Representations

A Bookshelf resource represents the metadata for a bookshelf, it does not include the volumes in the bookshelf.

```
{
  "kind": "books#bookshelf",
  "id": integer,
  "selfLink": string,
  "title": string,
  "description": string,
  "access": string,
  "updated": datetime,
  "created": datetime,
  "volumeCount": integer,
  "volumesLastUpdated": datetime
}
```

| Property Name | Value | Description | Notes |
|---|---|---|---|
| `kind` | `string` | Resource type for bookshelf metadata. |   |
| `id` | `integer` | ID of this bookshelf. |   |
| `title` | `string` | Title of this bookshelf. |   |
| `description` | `string` | Description of this bookshelf. |   |
| `access` | `string` | Whether this bookshelf is PUBLIC or PRIVATE. |   |
| `updated` | `datetime` | Last modified time of this bookshelf (formatted UTC timestamp with millisecond resolution). |   |
| `created` | `datetime` | Created time for this bookshelf (formatted UTC timestamp with millisecond resolution). |   |
| `volumeCount` | `integer` | Number of volumes in this bookshelf. |   |
| `volumesLastUpdated` | `datetime` | Last time a volume was added or removed from this bookshelf (formatted UTC timestamp with millisecond resolution). |   |
| `selfLink` | `string` | URL to this resource. |   |