Bookshelf
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
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 |
指向此资源的网址。 |
|
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-06-28。
[null,null,["最后更新时间 (UTC):2024-06-28。"],[[["\u003cp\u003eThe \u003ccode\u003eBookshelf\u003c/code\u003e collection enables you to view and manage bookshelf metadata and contents.\u003c/p\u003e\n"],["\u003cp\u003ePublic methods allow access to bookshelf data without authentication, while private methods require authentication for "My Library" interactions.\u003c/p\u003e\n"],["\u003cp\u003eA Bookshelf resource represents metadata such as title, description, access level, and volume count, but it does not include the actual volumes within the bookshelf.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve lists of bookshelves, individual bookshelf details, and modify "My Library" bookshelves using the provided methods.\u003c/p\u003e\n"]]],[],null,["# Bookshelf\n\nThe `Bookshelf` collection allows you to view bookshelf metadata as well as to modify the contents of a bookshelf.\n\nMethods\n-------\n\n\u003cbr /\u003e\n\nThe following methods apply to the public data about bookshelves and don't require authentication.\n[books.bookshelves.list](#method_books_bookshelves_list) \n[books.bookshelves.get](#method_books_bookshelves_get) \n\nThe following methods apply to the private, \"My Library\" view of bookshelves and require authentication.\n[books.mylibrary.bookshelves.list](#method_books_mylibrary_bookshelves_list) \n[books.mylibrary.bookshelves.get](#method_books_mylibrary_bookshelves_get) \n[books.mylibrary.bookshelves.addVolume](#method_books_mylibrary_bookshelves_addVolume) \n[books.mylibrary.bookshelves.removeVolume](#method_books_mylibrary_bookshelves_removeVolume) \n[books.mylibrary.bookshelves.clearVolumes](#method_books_mylibrary_bookshelves_clearVolumes)\n\n\u003cbr /\u003e\n\n[list](/books/docs/v1/reference/bookshelves/list)\n: Retrieves a list of public [Bookshelf resource](/books/docs/v1/reference/bookshelves) for the specified user.\n\n[get](/books/docs/v1/reference/bookshelves/get)\n: Retrieves a specific [Bookshelf resource](/books/docs/v1/reference/bookshelves) for the specified user.\n\nResource Representations\n------------------------\n\nA Bookshelf resource represents the metadata for a bookshelf, it does not include the volumes in the bookshelf.\n\n```text\n{\n \"kind\": \"books#bookshelf\",\n \"id\": integer,\n \"selfLink\": string,\n \"title\": string,\n \"description\": string,\n \"access\": string,\n \"updated\": datetime,\n \"created\": datetime,\n \"volumeCount\": integer,\n \"volumesLastUpdated\": datetime\n}\n```\n\n| Property Name | Value | Description | Notes |\n|----------------------|------------|--------------------------------------------------------------------------------------------------------------------|-------|\n| `kind` | `string` | Resource type for bookshelf metadata. | |\n| `id` | `integer` | ID of this bookshelf. | |\n| `title` | `string` | Title of this bookshelf. | |\n| `description` | `string` | Description of this bookshelf. | |\n| `access` | `string` | Whether this bookshelf is PUBLIC or PRIVATE. | |\n| `updated` | `datetime` | Last modified time of this bookshelf (formatted UTC timestamp with millisecond resolution). | |\n| `created` | `datetime` | Created time for this bookshelf (formatted UTC timestamp with millisecond resolution). | |\n| `volumeCount` | `integer` | Number of volumes in this bookshelf. | |\n| `volumesLastUpdated` | `datetime` | Last time a volume was added or removed from this bookshelf (formatted UTC timestamp with millisecond resolution). | |\n| `selfLink` | `string` | URL to this resource. | |"]]