Â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 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

get
Truy xuất Tài nguyên âm lượng 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 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ị Mô tả Ghi chú
kind string Loại tài nguyên của một ổ đĩa. (Ở 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 ổ đĩa. (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 này. (Trong phép 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 ổ đĩa 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, tối đa = 5)
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 của hình ảnh cho kích thước hình thu nhỏ (chiều rộ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). (trong 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). (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 sách 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 của ổ đĩa 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 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 ổ đĩa, 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 Sách này có bán hoặc được cung cấp miễn phí trong Google Sách điện tử tại quốc gia được liệt kê ở 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. Đâ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. (Ở 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. (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 nội dung của tập đó. Thông tin này có thể phụ 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 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 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. (theo phép chiếu LITE)
accessInfo.pdf object Thông tin về nội dung tệp 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. (Trong phép 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ó 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 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 không. (Ở 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 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 để 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ỉ 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_PURCHASE_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.