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 |
這個書架的上次修改時間 (採用世界標準時間的時間戳記格式,並以毫秒為單位的解析度)。 |
|
created |
datetime |
這個書架的建立時間 (採用世界標準時間的時間戳記格式,並以毫秒為單位的解析度)。 |
|
volumeCount |
integer |
這個書架中的磁碟區數量。 |
|
volumesLastUpdated |
datetime |
上次在這個書架中新增或移除磁碟區的時間 (採用世界標準時間的時間戳記格式,並以毫秒為單位的解析度)。 |
|
selfLink |
string |
這項資源的網址。 |
|
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-06-28 (世界標準時間)。
[null,null,["上次更新時間: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. | |"]]