Shelves

Get the books on a user's shelf:

shelf = client.shelf(user_id, shelf_name)
shelf.books # array of books on this shelf
shelf.start # start index of this page of paginated results
shelf.end # end index of this page of paginated results
shelf.total # total number of books on this shelf

Groups

Get group details:

group = client.group("id")
group.id # => group id
group.title # => group title
group.access # => group's access settings# => (e.g., public or private)
group.group_users_count # => number of users in the group

List the groups a given user is a member of:

group_list = client.group_list("user_id", "sort")
group_list.total # => total number of groups
group_list.group.count # => number of groups returned in the request# Loop through the list to get details for each of the groups.
group_list.group.each do |g|
g.id # => group id
g.access # => access settings (private, public)
g.users_count # => number of members
g.title # => title
g.image_url # => url of the group's image
g.last_activity_at # => date and time of the group's last activityend

The sort parameter is optional, and defaults to my_activity.
For other sorting options, see here.

OAuth

For API calls requiring permission, such as write operations or browsing friends,
see our OAuth tutorial.