Bookshelf

  • The Bookshelf collection enables you to view and manage bookshelf metadata and contents.

  • Public methods allow access to bookshelf data without authentication, while private methods require authentication for "My Library" interactions.

  • A Bookshelf resource represents metadata such as title, description, access level, and volume count, but it does not include the actual volumes within the bookshelf.

  • You can retrieve lists of bookshelves, individual bookshelf details, and modify "My Library" bookshelves using the provided methods.
The Bookshelf collection allows you to view bookshelf metadata as well as to modify the contents of a bookshelf.

Methods

The following methods apply to the public data about bookshelves and don't require authentication.
books.bookshelves.list

list
Retrieves a list of public Bookshelf resource for the specified user.
get
Retrieves a specific Bookshelf resource 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).