Volume
集合是用於搜尋或列出書架內容。這個集合是唯讀集合。方法
下列方法適用於磁碟區相關的公開資料,因此不需要驗證。
books.volumes.list
資源表示法
Volume 是指 Google 圖書代管書籍或雜誌的資訊。內含中繼資料 (例如書名和作者) 以及個人化資料 (例如是否已購買)。(以下說明 LITE 投影所提供的磁碟區欄位)。
{ "kind": "books#volume", "id": string, "etag": string, "selfLink": string, "volumeInfo": { "title": string, "subtitle": string, "authors": [ string ], "publisher": string, "publishedDate": string, "description": string, "industryIdentifiers": [ { "type": string, "identifier": string } ], "pageCount": integer, "dimensions": { "height": string, "width": string, "thickness": string }, "printType": string, "mainCategory": string, "categories": [ string ], "averageRating": double, "ratingsCount": integer, "contentVersion": string, "imageLinks": { "smallThumbnail": string, "thumbnail": string, "small": string, "medium": string, "large": string, "extraLarge": string }, "language": string, "previewLink": string, "infoLink": string, "canonicalVolumeLink": string }, "userInfo": { "review": mylibrary.reviews Resource, "readingPosition": mylibrary.readingpositions Resource, "isPurchased": boolean, "isPreordered": boolean, "updated": datetime }, "saleInfo": { "country": string, "saleability": string, "onSaleDate": datetime, "isEbook": boolean, "listPrice": { "amount": double, "currencyCode": string }, "retailPrice": { "amount": double, "currencyCode": string }, "buyLink": string }, "accessInfo": { "country": string, "viewability": string, "embeddable": boolean, "publicDomain": boolean, "textToSpeechPermission": string, "epub": { "isAvailable": boolean, "downloadLink": string, "acsTokenLink": string }, "pdf": { "isAvailable": boolean, "downloadLink": string, "acsTokenLink": string }, "webReaderLink": string, "accessViewStatus": string, "downloadAccess": { "kind": "books#downloadAccessRestriction", "volumeId": string, "restricted": boolean, "deviceAllowed": boolean, "justAcquired": boolean, "maxDownloadDevices": integer, "downloadsAcquired": integer, "nonce": string, "source": string, "reasonCode": string, "message": string, "signature": string } }, "searchInfo": { "textSnippet": string } }
資源名稱 | 價值 | 說明 | 附註 |
---|---|---|---|
kind |
string |
磁碟區的資源類型。(在 LITE 投影中)。 | |
id |
string |
磁碟區的專屬 ID。(在 LITE 投影中)。 | |
etag |
string |
磁碟區資源特定版本的不透明 ID。(在 LITE 投影中) | |
selfLink |
string |
這項資源的網址。(在 LITE 投影中)。 | |
volumeInfo |
object |
一般磁碟區資訊。 | |
volumeInfo.title |
string |
書冊標題。(在 LITE 投影中)。 | |
volumeInfo.subtitle |
string |
磁碟區副標題。(在 LITE 投影中)。 | |
volumeInfo.authors[] |
list |
這個磁碟區的作者和/或編輯者名稱。(在 LITE 投影中) | |
volumeInfo.publisher |
string |
此冊的發布者。(在 LITE 投影中)。 | |
volumeInfo.publishedDate |
string |
出版日期。(在 LITE 投影中)。 | |
volumeInfo.description |
string |
磁碟區概要。說明文字會採用 HTML 格式,包含簡單的格式元素,例如 b、i 和 br 標記。(LITE 投影中) | |
volumeInfo.industryIdentifiers[] |
list |
此磁碟區的業界標準 ID。 | |
volumeInfo.industryIdentifiers[].type |
string |
ID 類型。可能的值包括 ISBN_10、ISBN_13、ISSN 和 OTHER。 | |
volumeInfo.industryIdentifiers[].identifier |
string |
產業專屬磁碟區 ID。 | |
volumeInfo.pageCount |
integer |
總網頁數。 | |
volumeInfo.dimensions |
object |
項目的實際尺寸。 | |
volumeInfo.dimensions.height |
string |
這個磁碟區的高度或長度 (公分)。 | |
volumeInfo.dimensions.width |
string |
這個音量的寬度 (公分)。 | |
volumeInfo.dimensions.thickness |
string |
這個磁碟區的粗細 (公分)。 | |
volumeInfo.printType |
string |
這冊的出版類型。可能的值為 BOOK 或 MAGAZINE。 | |
volumeInfo.categories[] |
list |
主題類別清單,例如「虛構」、「懸疑」等。 | |
volumeInfo.averageRating |
double |
這個數量的平均評論評分。(最小值 = 1.0,最大值 = 5.0) | |
volumeInfo.ratingsCount |
integer |
這個數量的評論評分次數。 | |
volumeInfo.contentVersion |
string |
磁碟區內容版本 (文字和圖片) 的 ID。(在 LITE 投影中) | |
volumeInfo.imageLinks |
object |
所有可用大小的圖片連結清單。(LITE 投影中) | |
volumeInfo.imageLinks.thumbnail |
string |
縮圖大小的圖片連結 (寬度約 128 像素)。(LITE 投影中) | |
volumeInfo.imageLinks.small |
string |
小型圖片的連結 (寬度約 300 像素)。(LITE 投影中) | |
volumeInfo.imageLinks.medium |
string |
中等尺寸的圖片連結 (寬度約 575 像素)。(LITE 投影中) | |
volumeInfo.imageLinks.large |
string |
大型圖片連結 (寬度約 800 像素)。(LITE 投影中) | |
volumeInfo.imageLinks.smallThumbnail |
string |
小型縮圖大小的圖片連結 (寬度約 80 像素)。(LITE 投影中) | |
volumeInfo.imageLinks.extraLarge |
string |
超大尺寸的圖片連結 (寬度約 1280 像素)。(LITE 投影中) | |
volumeInfo.language |
string |
這個磁碟區的最佳語言 (根據內容)。是兩個字母的 ISO 639-1 代碼,例如「fr」、「en」等。 | |
volumeInfo.mainCategory |
string |
這個磁碟區所屬的主要類別。從下方傳回的類別清單中,系統會找出權重最高的類別。 | |
volumeInfo.previewLink |
string |
在 Google 圖書網站上預覽本冊內容的網址。 | |
userInfo |
object |
與這個磁碟區相關的使用者資訊。(例如:這位使用者上次閱讀的頁面,或是否購買了這本書) | |
userInfo.review |
nested object |
這位使用者對這個磁碟區的評論 (如有)。 | |
userInfo.readingPosition |
readingPosition Resource |
使用者目前在磁碟區中的閱讀位置 (如果有的話)。(在 LITE 投影中)。 | |
userInfo.isPurchased |
boolean |
這個磁碟區是否由提出要求的已驗證使用者購買。(在 LITE 投影中)。 | |
saleInfo |
object |
與電子書店和/或可購買性相關的任何書籍資訊。這類資訊可能會因要求來源國家/地區而異 (例如書籍不得在特定國家/地區銷售)。 | |
saleInfo.country |
string |
這項銷售資訊有效的雙字母 ISO_3166-1 國家/地區代碼。(在 LITE 投影中)。 | |
saleInfo.saleability |
string |
指出這本書是否在上述國家/地區的 Google 電子書商店中開放銷售或免費提供。可能的值包括 FOR_SALE、FREE、NOT_FOR_SALE 或 FOR_PREORDER。 | |
saleInfo.isEbook |
boolean |
此冊是否為電子書 (可加到「我的電子書」書架中)。 | |
saleInfo.listPrice |
object |
建議零售價格。(LITE 投影中) | |
saleInfo.listPrice.amount |
double |
下列貨幣顯示的金額:(在 LITE 投影中)。 | |
saleInfo.listPrice.currencyCode |
string |
ISO 4217,三字母貨幣代碼。(在 LITE 投影中)。 | |
saleInfo.retailPrice |
object |
書籍的實際售價。除非這類大量商品有優惠或折扣,否則與建議零售或定價相同。(LITE 投影中) | |
saleInfo.retailPrice.amount |
double |
下列貨幣顯示的金額:(在 LITE 投影中)。 | |
saleInfo.retailPrice.currencyCode |
string |
ISO 4217,三字母貨幣代碼。(在 LITE 投影中)。 | |
saleInfo.buyLink |
string |
前往 Google 圖書網站購買本冊的網址。(LITE 投影中) | |
accessInfo |
object |
與閱讀或取得該磁碟區文字相關的任何資訊。這類資訊取決於國家/地區 (書籍可能在某個國家/地區為公版資源,而非在另一個國家/地區,例如 | |
accessInfo.country |
string |
此存取權資訊有效的雙字母 ISO_3166-1 國家/地區代碼。(在 LITE 投影中)。 | |
accessInfo.viewability |
string |
磁碟區的讀取權限。可能的值包括 PARTIAL、ALL_PAGES、NO_PAGES 或 UNKNOWN。這個值因上述國家/地區而異。如果值為 PARTIAL 表示發布商允許在不購買的情況下公開閱覽部分書籍內容。這適用於電子書和非電子書。公版著作書籍的值一律為 ALL_PAGES。 | |
accessInfo.epub |
object |
epub 內容相關資訊。(LITE 投影中) | |
accessInfo.epub.downloadLink |
string |
epub 下載網址。(在 LITE 投影中)。 | |
accessInfo.epub.acsTokenLink |
string |
用於擷取 epub 下載的 ACS 權杖的網址。(在 LITE 投影中)。 | |
accessInfo.pdf |
object |
PDF 內容的相關資訊。(LITE 投影中) | |
accessInfo.pdf.downloadLink |
string |
PDF 的下載網址。(在 LITE 投影中)。 | |
accessInfo.pdf.acsTokenLink |
string |
擷取 ACS 權杖的網址。(在 LITE 投影中)。 | |
accessInfo.accessViewStatus |
string |
將這個數量的存取權和可視度合併為這位使用者的單一狀態欄位。值可以是 FULL_PURCHASED、FULL_PUBLIC_DOMAIN、SAMPLE 或 NONE。(在 LITE 投影中)。 | |
accessInfo.embeddable |
boolean |
指定該磁碟區能否使用嵌入式檢視器 API 嵌入可視區域內。 | |
accessInfo.publicDomain |
boolean |
這本書是否為上述國家/地區的公版著作。 | |
|
string |
前往 Google 圖書網站查看該冊次相關資訊的網址。(在 LITE 投影中) | |
userInfo.updated |
datetime |
使用者動作 (例如閱讀進度更新、購買量或撰寫評論) 上次修改這冊時的時間戳記。(RFC 3339 世界標準時間日期時間格式)。 | |
volumeInfo.canonicalVolumeLink |
string |
磁碟區的標準網址。(在 LITE 投影中)。 | |
userInfo.isPreordered |
boolean |
提出要求的已驗證使用者預購這個磁碟區。(在 LITE 投影中)。 | |
saleInfo.onSaleDate |
datetime |
這本書的販售日期。 | |
accessInfo.textToSpeechPermission |
string |
是否允許將文字轉語音功能用於這個磁碟區。值可以是「ALLOWED」、「ALLOWED_FOR_ACCESSIBILITY」或「NOT_ALLOWED」。 | |
accessInfo.epub.isAvailable |
boolean |
文字重排式 EPUB 檔案,內容為公共領域資源或可供購買。(在 LITE 投影中)。 | |
accessInfo.pdf.isAvailable |
boolean |
是公版資源或可供購買的掃描圖片 PDF 檔案。(在 LITE 投影中)。 | |
accessInfo.webReaderLink |
string |
可在 Google 圖書網站上閱讀本冊內容的網址。連結將不允許使用者讀取不可見的磁碟區。 | |
accessInfo.downloadAccess |
nested object |
磁碟區下載授權存取限制的相關資訊。 | |
accessInfo.downloadAccess.kind |
string |
資源類型。 | |
accessInfo.downloadAccess.volumeId |
string |
識別適用此項目的磁碟區。 | |
accessInfo.downloadAccess.restricted |
boolean |
這個磁碟區是否設有下載存取限制。 | |
accessInfo.downloadAccess.deviceAllowed |
boolean |
如果有所限制,是否授予此權限 (使用者、裝置、磁碟區) 的存取權。 | |
accessInfo.downloadAccess.justAcquired |
boolean |
如果 deviceAllowed,存取這項要求是否剛剛取得存取權。 | |
accessInfo.downloadAccess.maxDownloadDevices |
integer |
如果限制,這個磁碟區的內容下載授權數量上限。 | |
accessInfo.downloadAccess.downloadsAcquired |
integer |
如果設有限制,已取得的內容下載授權數量 (如有授權的用戶端,則包括在內)。 | |
accessInfo.downloadAccess.nonce |
string |
用於驗證的用戶端 Nonce。僅下載存取權和客戶驗證。 | |
accessInfo.downloadAccess.source |
string |
用於驗證的用戶端應用程式 ID。僅下載存取權和客戶驗證。 | |
accessInfo.downloadAccess.reasonCode |
string |
錯誤/警告原因代碼。日後可能會新增其他代碼。0 確定 100 ACCESS_DENIED_PUBLISHER_LIMIT 101 ACCESS_DENIED_LIMIT 200 WARNING_USED_LAST_ACCESS | |
accessInfo.downloadAccess.message |
string |
錯誤/警示訊息。 | |
accessInfo.downloadAccess.signature |
string |
回應簽章。 | |
searchInfo |
object |
與這個磁碟區相關的搜尋結果資訊。 | |
searchInfo.textSnippet |
string |
包含搜尋查詢的文字片段。 |