Âm lượng

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

Phương thức

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

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

get
Truy xuất Tài nguyên phương tiện dựa trên mã nhận dạng.
list
Tìm kiếm sách.

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