Âm lượng

Bộ sưu tập Volume dùng để tìm kiếm hoặc liệt kê nội dung của một giá sách. Bộ sưu tập này chỉ có thể đọc.

Phương thức

Các phương thức sau áp dụng cho dữ liệu công khai về ổ đĩa và không yêu cầu xác thực.
books.volumes.list
books.volumes.get

Phương pháp sau áp dụng cho chế độ xem riêng tư "Thư viện của tôi" của các tập và yêu cầu xác thực.
books.mylibrary.bookshelves.volumes.list

nhận
Truy xuất Tài nguyên ổ đĩa dựa trên mã nhận dạng.
list
Tìm sách.

Bản trình bày tài nguyên

Tập thể hiện thông tin mà Google Sách lưu trữ về một cuốn sách hoặc tạp chí. Nội dung chứa siêu dữ liệu như tiêu đề và tác giả, cũng như dữ liệu được cá nhân hoá, chẳng hạn như việc nội dung đó đã được mua hay chưa. (Các trường thể tích có sẵn trong phép chiếu LITE được ghi chú bên dưới).

{
  "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
  }
}
Tên thuộc tính Giá trị Nội dung mô tả Ghi chú
kind string Loại tài nguyên của một ổ đĩa. (Trong phép chiếu LITE.)
id string Giá trị nhận dạng duy nhất của một ổ đĩa. (Trong phép chiếu LITE.)
etag string Giá trị nhận dạng mờ cho một phiên bản cụ thể của tài nguyên ổ đĩa. (Trong phép chiếu LITE)
volumeInfo object Thông tin chung về dung lượng.
volumeInfo.title string Tiêu đề tập. (Trong phép chiếu LITE.)
volumeInfo.subtitle string Phụ đề âm lượng. (Trong phép chiếu LITE.)
volumeInfo.authors[] list Tên tác giả và/hoặc người biên tập của tập này. (Trong phép chiếu LITE)
volumeInfo.publisher string Nhà xuất bản của tập này. (Trong phép chiếu LITE.)
volumeInfo.publishedDate string Ngày xuất bản. (Trong phép chiếu LITE.)
volumeInfo.description string Bản tóm tắt về tập. Văn bản mô tả được định dạng bằng HTML và bao gồm các yếu tố định dạng đơn giản, chẳng hạn như các thẻ b, i và br. (trong phép chiếu LITE)
volumeInfo.industryIdentifiers[] list Giá trị nhận dạng tiêu chuẩn ngành cho tập này.
volumeInfo.industryIdentifiers[].type string Loại giá trị nhận dạng. Giá trị có thể là ISBN_10, ISBN_13, ISSN và OTHER.
volumeInfo.industryIdentifiers[].identifier string Giá trị nhận dạng số lượng cụ thể theo ngành.
volumeInfo.pageCount integer Tổng số trang.
volumeInfo.dimensions object Kích thước vật lý của thể tích này.
volumeInfo.dimensions.height string Chiều cao hoặc chiều dài của ổ đĩa này (tính bằng cm).
volumeInfo.dimensions.width string Chiều rộng của ổ đĩa này (tính bằng cm).
volumeInfo.dimensions.thickness string Độ dày của thể tích này (tính bằng cm).
volumeInfo.printType string Loại ấn bản của tập này. Giá trị có thể là BOOK hoặc MAGAZINE.
volumeInfo.categories[] list Danh sách danh mục chủ đề, chẳng hạn như "Tiểu thuyết", "Hồi hộp", v.v.
volumeInfo.averageRating double Điểm xếp hạng đánh giá trung bình cho tập này. (tối thiểu = 1, tối đa = 5)
volumeInfo.ratingsCount integer Số lượt xếp hạng bài đánh giá cho tập này.
volumeInfo.contentVersion string Giá trị nhận dạng cho phiên bản của nội dung âm lượng (văn bản và hình ảnh). (Trong phép chiếu LITE)
volumeInfo.imageLinks.thumbnail string Đường liên kết của hình ảnh cho kích thước hình thu nhỏ (chiều rộng ~128 pixel). (trong phép chiếu LITE)
volumeInfo.imageLinks.small string Đường liên kết của hình ảnh có kích thước nhỏ (chiều rộng ~300 pixel). (trong phép chiếu LITE)
volumeInfo.imageLinks.medium string Đường liên kết của hình ảnh có kích thước trung bình (chiều rộng ~575 pixel). (trong phép chiếu LITE)
volumeInfo.imageLinks.large string Đường liên kết của hình ảnh có kích thước lớn (chiều rộng ~800 pixel). (trong phép chiếu LITE)
volumeInfo.imageLinks.smallThumbnail string Đường liên kết của hình ảnh dành cho hình thu nhỏ có kích thước nhỏ (chiều rộng ~80 pixel). (trong phép chiếu LITE)
volumeInfo.imageLinks.extraLarge string Đường liên kết của hình ảnh có kích thước cực lớn (chiều rộng ~1280 pixel). (trong phép chiếu LITE)
volumeInfo.language string Ngôn ngữ phù hợp nhất cho tập này (dựa trên nội dung). Đó là mã gồm hai chữ cái theo ISO 639-1 như 'fr', 'en', v.v.
volumeInfo.mainCategory string Danh mục chính chứa tập này. Đó sẽ là danh mục có trọng số cao nhất trong danh sách danh mục được trả về bên dưới.
userInfo object Thông tin cụ thể về người dùng liên quan đến tập này. (ví dụ: trang mà người dùng này đọc lần cuối hoặc việc họ có mua sách này không)
userInfo.review nested object Bài đánh giá của người dùng này về tập này, nếu có.
userInfo.readingPosition readingPosition Resource Vị trí đọc hiện tại của người dùng trong âm lượng, nếu có. (Trong phép chiếu LITE.)
userInfo.isPurchased boolean Liệu người dùng đã xác thực đưa ra yêu cầu có mua tập này hay không. (Trong phép chiếu LITE.)
saleInfo object Bất kỳ thông tin nào về một tập sách liên quan đến Cửa hàng sách điện tử và/hoặc khả năng mua được. Thông tin này có thể phụ thuộc vào quốc gia bắt nguồn yêu cầu (tức là có thể không bán sách ở một số quốc gia nhất định).
saleInfo.country string Mã quốc gia gồm hai chữ cái theo ISO_3166-1 mà thông tin bán hàng này hợp lệ. (Trong phép chiếu LITE.)
saleInfo.saleability string Sách này có được bán hoặc được cung cấp miễn phí trong Cửa hàng sách điện tử của Google đối với quốc gia được liệt kê ở trên hay không. Giá trị có thể là FOR_Sale, FREE, NOT_FOR_SALES hoặc FOR_PREORDER.
saleInfo.isEbook boolean Tập này có phải là Sách điện tử hay không (có thể thêm vào giá Sách điện tử của tôi).
saleInfo.listPrice object Giá bán lẻ đề xuất. (trong phép chiếu LITE)
saleInfo.listPrice.amount double Số tiền bằng đơn vị tiền tệ được liệt kê bên dưới. (Trong phép chiếu LITE.)
saleInfo.listPrice.currencyCode string Mã đơn vị tiền tệ gồm ba chữ cái theo ISO 4217. (Trong phép chiếu LITE.)
saleInfo.retailPrice object Giá bán thực tế của sách. Đây là mức giá giống với giá bán lẻ hoặc giá niêm yết được đề xuất trừ phi có ưu đãi hoặc giảm giá cho số lượng sách này. (trong phép chiếu LITE)
saleInfo.retailPrice.amount double Số tiền bằng đơn vị tiền tệ được liệt kê bên dưới. (Trong phép chiếu LITE.)
saleInfo.retailPrice.currencyCode string Mã đơn vị tiền tệ gồm ba chữ cái theo ISO 4217. (Trong phép chiếu LITE.)
accessInfo object Thông tin bất kỳ về một tập nào đó liên quan đến việc đọc hoặc nhận văn bản về tập đó. Thông tin này có thể phụ thuộc vào quốc gia (chẳng hạn như sách có thể thuộc phạm vi công cộng ở một quốc gia này nhưng không thuộc phạm vi công cộng ở một quốc gia khác).
accessInfo.country string Mã quốc gia gồm hai chữ cái theo ISO_3166-1 mà thông tin truy cập này hợp lệ. (Trong phép chiếu LITE.)
accessInfo.viewability string Quyền đọc một tập. Giá trị có thể là PARTIAL, ALL_PAGES, NO_PAGES hoặc UNKNOWN. Giá trị này phụ thuộc vào quốc gia được liệt kê ở trên. Giá trị partIAL có nghĩa là nhà xuất bản đã cho phép xem công khai một số phần của tập sách mà không cần mua. Danh sách này có thể áp dụng cho cả sách điện tử lẫn sách điện tử không phải sách điện tử. Sách trên phạm vi công cộng sẽ luôn có giá trị là ALL_PAGES.
accessInfo.epub object Thông tin về nội dung epub. (trong phép chiếu LITE)
accessInfo.pdf object Thông tin về nội dung tệp pdf. (trong phép chiếu LITE)
accessInfo.accessViewStatus string Kết hợp quyền truy cập và khả năng xem của ổ đĩa này vào một trường trạng thái duy nhất cho người dùng này. Giá trị có thể là FULL_PURCHASED, FULL_PUBLIC_DOMAIN, SAMPLE hoặc NONE. (Trong phép chiếu LITE.)
accessInfo.embeddable boolean Liệu ổ đĩa này có thể được nhúng vào khung nhìn bằng API trình xem được nhúng hay không.
accessInfo.publicDomain boolean Sách này có thuộc phạm vi công cộng ở quốc gia nêu trên hay không.
userInfo.updated datetime Dấu thời gian khi tập này được sửa đổi lần gần đây nhất bằng một hành động của người dùng, chẳng hạn như cập nhật vị trí đọc, mua số lượng lớn hoặc viết bài đánh giá. (Định dạng ngày giờ UTC 3339).
userInfo.isPreordered boolean Liệu người dùng đã xác thực gửi yêu cầu có đặt hàng trước tập này hay không. (Trong phép chiếu LITE.)
saleInfo.onSaleDate datetime Ngày sách này có sẵn để bán.
accessInfo.textToSpeechPermission string Liệu âm lượng này có được phép chuyển văn bản sang lời nói hay không. Giá trị có thể là ALLOWED, ALLOWED_FOR_ACCESSIBILITY hoặc NOT_ALLOWED.
accessInfo.epub.isAvailable boolean Có phải tệp epub của văn bản tự xuống dòng có sẵn dưới dạng miền công cộng hoặc để mua. (Trong phép chiếu LITE.)
accessInfo.pdf.isAvailable boolean Bản pdf ảnh được quét có thể ở dạng phạm vi công cộng hoặc có thể mua. (Trong phép chiếu LITE.)
accessInfo.downloadAccess nested object Thông tin về các quy định hạn chế liên quan đến quyền truy cập vào giấy phép tải xuống của một tập sách.
accessInfo.downloadAccess.kind string Loại tài nguyên.
accessInfo.downloadAccess.volumeId string Xác định số lượng được áp dụng mục nhập này.
accessInfo.downloadAccess.restricted boolean Liệu ổ đĩa này có bất kỳ giới hạn truy cập tải xuống nào hay không.
accessInfo.downloadAccess.deviceAllowed boolean Nếu bị hạn chế, thì quyền truy cập có được cấp cho thiết bị này hay không (người dùng, thiết bị, âm lượng).
accessInfo.downloadAccess.justAcquired boolean Nếu deviceAllowed, quyền truy cập vừa được thu nạp qua yêu cầu này hay chưa.
accessInfo.downloadAccess.maxDownloadDevices integer Nếu bị hạn chế, số lượng giấy phép tải nội dung xuống tối đa cho ổ đĩa này.
accessInfo.downloadAccess.downloadsAcquired integer Nếu bị hạn chế, số lượng giấy phép tải nội dung xuống đã được cấp (bao gồm cả ứng dụng yêu cầu, nếu được cấp phép).
accessInfo.downloadAccess.nonce string Số chỉ dùng một lần của ứng dụng để xác minh. Chỉ quyền truy cập tải xuống và xác thực ứng dụng.
accessInfo.downloadAccess.source string Mã nhận dạng ứng dụng khách để xác minh. Chỉ quyền truy cập tải xuống và xác thực ứng dụng.
accessInfo.downloadAccess.reasonCode string Mã lý do lỗi/cảnh báo. Các mã bổ sung có thể được thêm trong tương lai. 0 OK 100 ACCESS_DENIED_PUBLISHER_LIMIT 101 ACCESS_DENIED_LIMIT 200 WARNING_USE_LAST_ACCESS
accessInfo.downloadAccess.message string Thông báo lỗi/cảnh báo.
accessInfo.downloadAccess.signature string Chữ ký phản hồi.
searchInfo object Thông tin về kết quả tìm kiếm liên quan đến tập này.
searchInfo.textSnippet string Một đoạn mã văn bản có chứa cụm từ tìm kiếm.