v1

latestOpenAPI 3.0.32026-07-1711821.4 KB
LibraryService

ListBooks

Lists books in a shelf. The order is unspecified but deterministic. Newly created books will not necessarily be added to the end of this list. Returns NOT_FOUND if the shelf does not exist.

get/v1/shelves/{shelf}/books

Path parameters

shelfstring required

The shelf id.

Query parameters

page_sizeinteger

Requested page size. Server may return fewer books than requested. If unspecified, server will pick an appropriate default.

page_tokenstring

A token identifying a page of results the server should return. Typically, this is the value of [ListBooksResponse.next_page_token][google.example.library.v1.ListBooksResponse.next_page_token]. returned from the previous call to ListBooks method.

Response

OK

next_page_tokenstring

A token to retrieve next page of results. Pass this value in the [ListBooksRequest.page_token][google.example.library.v1.ListBooksRequest.page_token] field in the subsequent call to ListBooks method to retrieve the next page of results.