磁碟區

Volume 集合是用於搜尋或列出書架內容。這個集合是唯讀集合。

方法

下列方法適用於磁碟區相關的公開資料，因此不需要驗證。
books.volumes.list
books.volumes.get

以下方法適用於私人的「我的圖書館」磁碟區檢視畫面，且需要驗證。
books.mylibrary.bookshelves.volumes.list

取得
依據 ID 擷取磁碟區資源。
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 投影中)
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.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 這個磁碟區所屬的主要類別。從下方傳回的類別清單中，系統會找出權重最高的類別。
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 投影中)。
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.pdf object PDF 內容的相關資訊。(LITE 投影中)
accessInfo.accessViewStatus string 將這個數量的存取權和可視度合併為這位使用者的單一狀態欄位。值可以是 FULL_PURCHASED、FULL_PUBLIC_DOMAIN、SAMPLE 或 NONE。(在 LITE 投影中)。
accessInfo.embeddable boolean 指定該磁碟區能否使用嵌入式檢視器 API 嵌入可視區域內。
accessInfo.publicDomain boolean 這本書是否為上述國家/地區的公版著作。
userInfo.updated datetime 使用者動作 (例如閱讀進度更新、購買量或撰寫評論) 上次修改這冊時的時間戳記。(RFC 3339 世界標準時間日期時間格式)。
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.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 包含搜尋查詢的文字片段。