Bookshelf
集合可用于查看书架元数据以及修改书架的内容。
方法
以下方法适用于有关书架的公开数据,无需进行身份验证。
books.bookshelves.listbooks.bookshelves.get
books.mylibrary.bookshelves.get
books.mylibrary.bookshelves.addVolume
books.mylibrary.bookshelves.removeVolume
books.mylibrary.bookshelves.clearVolumes
以下方法适用于书架的不公开“我的图书馆”视图,需要进行身份验证。
books.mylibrary.bookshelves.listbooks.mylibrary.bookshelves.get
books.mylibrary.bookshelves.addVolume
books.mylibrary.bookshelves.removeVolume
books.mylibrary.bookshelves.clearVolumes
- list
- 检索指定用户的公开 Bookshelf 资源列表。
- get
- 检索指定用户的特定 Bookshelf 资源。
资源表示法
Bookshelf 资源表示书架的元数据,但不包括书架中的卷。
{ "kind": "books#bookshelf", "id": integer, "selfLink": string, "title": string, "description": string, "access": string, "updated": datetime, "created": datetime, "volumeCount": integer, "volumesLastUpdated": datetime }
物业名称 | 价值 | 说明 | 备注 |
---|---|---|---|
kind |
string |
书架元数据的资源类型。 | |
id |
integer |
此书架的 ID。 | |
title |
string |
此书架的标题。 | |
description |
string |
此书架的说明。 | |
access |
string |
此书架的状态是“公开”还是“私享”。 | |
updated |
datetime |
此书架的上次修改时间(采用 UTC 时间戳格式,分辨率为毫秒级)。 | |
created |
datetime |
此书架的创建时间(采用 UTC 时间戳格式,分辨率为毫秒级)。 | |
volumeCount |
integer |
此书架中的卷数。 | |
volumesLastUpdated |
datetime |
上次在此书架中添加或移除卷的时间(采用 UTC 时间戳格式,分辨率为毫秒级)。 | |
selfLink |
string |
指向此资源的网址。 |