磁碟區

Volume 集合可用於執行搜尋或列出書櫃的內容。這個集合是唯讀集合。

方法

下列方法適用於卷宗的公開資料，且不需要驗證。
books.volumes.list
books.volumes.get

以下方法適用於「我的媒體庫」的私人資料夾檢視畫面，且需要驗證。
books.mylibrary.bookshelves.volumes.list

get
根據 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 這個卷是否可使用 Embedded Viewer 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 為 true，表示是否剛剛透過這項要求取得存取權。
accessInfo.downloadAccess.maxDownloadDevices integer 如果限制，這個磁碟區的內容下載授權數量上限。
accessInfo.downloadAccess.downloadsAcquired integer 如果受限制，則為已取得的內容下載授權數量 (包括要求的用戶端，如果已授權)。
accessInfo.downloadAccess.nonce string 用於驗證的用戶端 Nonce。僅下載存取權和客戶驗證。
accessInfo.downloadAccess.source string 用於驗證的用戶端應用程式 ID。僅下載存取權和客戶驗證。
accessInfo.downloadAccess.reasonCode string 錯誤/警告原因代碼。日後可能會新增其他代碼。0 OK 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 包含搜尋查詢的文字片段。