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

Phương pháp

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

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

tải
Truy xuất tài nguyên Âm lượng dựa trên mã nhận dạng.
list
Thực hiện tìm kiếm sách.

Biểu diễn 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í. Báo cáo này chứa siêu dữ liệu, chẳng hạn như tiêu đề và tác giả, cũng như dữ liệu được cá nhân hoá, chẳng hạn như dữ liệu này đã được mua hay chưa. (Bạn có thể xem các trường âm lượng có trong phép chiếu LITE ở 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 tài sản Giá trị Mô tả Ghi chú
kind string Loại tài nguyên cho một ổ đĩa. (Trong phép chiếu LITE.)
id string Giá trị nhận dạng duy nhất của một tập. (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 số lượng. (Trong phép chiếu LITE)
volumeInfo object Thông tin chung về số lượng.
volumeInfo.title string Tên 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 của các tác giả và/hoặc người chỉnh sửa cho 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 số lượng. Văn bản của phần mô tả có định dạng HTML và bao gồm các phần tử định dạng đơn giản như 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. Các giá trị có thể là ISBN_10, ISBN_13, ISSN và OTHER.
volumeInfo.industryIdentifiers[].identifier string Mã nhận dạng khối lượng cụ thể theo ngành.
volumeInfo.pageCount integer Tổng số trang.
volumeInfo.dimensions object Kích thước thực của tập này.
volumeInfo.dimensions.height string Chiều cao hoặc chiều dài của thể tích này (tính bằng cm).
volumeInfo.dimensions.width string Chiều rộng của thể tích 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 hình xuất bản tập này. Các giá trị có thể là BOOK hoặc MAGAZINE.
volumeInfo.categories[] list Danh sách các danh mục chủ đề, chẳng hạn như "Fiction", "Suspense", v.v.
volumeInfo.averageRating double Điểm xếp hạng trung bình của bài đánh giá này. (tối thiểu = 1.0, tối đa = 5.0)
volumeInfo.ratingsCount integer Số lượt xếp hạng bài đánh giá này.
volumeInfo.contentVersion string Giá trị nhận dạng cho phiên bản của nội dung 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 để biết kích thước hình thu nhỏ (khoảng 128 pixel). (trong phép chiếu LITE)
volumeInfo.imageLinks.small string Liên kết hình ảnh cho 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 cho kích thước trung bình (chiều rộng ~575 pixel). (trong phép chiếu LITE)
volumeInfo.imageLinks.large string Liên kết 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 cho kích thước hình thu 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 các tập này. Đây sẽ là danh mục từ danh sách danh mục được trả về bên dưới có trọng số cao nhất.
userInfo object Thông tin cụ thể của 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 họ có mua cuốn sách này không)
userInfo.review nested object Bài đánh giá của người dùng này về phương tiện nhớ 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ó. (Trong phép chiếu LITE.)
userInfo.isPurchased boolean Tập này có do người dùng đã xác thực mua yêu cầu hay không. (Trong phép chiếu LITE.)
saleInfo object Mọi thông tin 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. Thông tin này có thể phụ thuộc vào quốc gia xuất phát của yêu cầu (tức là sách có thể không được bán ở 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 Liệu có thể bán hoặc cung cấp sách miễn phí này 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, MIỄN PHÍ, NOT_FOR_SALE 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ể được thêm vào Kệ 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 trong đơn vị tiền tệ được liệt kê bên dưới. (Trong phép chiếu LITE.)
saleInfo.listPrice.currencyCode string Mã 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 cuốn 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 tập này. (trong phép chiếu LITE)
saleInfo.retailPrice.amount double Số tiền trong đơn vị tiền tệ được liệt kê bên dưới. (Trong phép chiếu LITE.)
saleInfo.retailPrice.currencyCode string Mã tiền tệ gồm ba chữ cái theo ISO 4217. (Trong phép chiếu LITE.)
accessInfo object Mọi thông tin về một tập sách có liên quan đến việc đọc hoặc lấy nội dung của tập đó. Thông tin này có thể phụ thuộc vào quốc gia (sách có thể thuộc phạm vi công cộng ở một quốc gia nhưng không nằm trong một quốc gia khác, ví dụ:).
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 của một tập. Các 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 nêu trên. Giá trị của PARTIAL có nghĩa là nhà xuất bản đã cho phép xem một phần của số lượng này ở chế độ xem công khai mà không cần mua. Điều này có thể áp dụng cho sách điện tử cũng như sách điện tử. Sách trong 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 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 phương tiện nhớ 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 khối lượng này có được nhúng vào khung nhìn bằng cách sử dụng API trình xem được nhúng hay không.
accessInfo.publicDomain boolean Liệu 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 lần chỉnh sửa này gần đây nhất bởi 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 hoặc viết bài đánh giá. (Định dạng ngày-giờ UTC RFC 3339).
userInfo.isPreordered boolean Tập này có do người dùng đã xác thực đặt trước yêu cầu hay không. (Trong phép chiếu LITE.)
saleInfo.onSaleDate datetime Ngày có bán cuốn sách này.
accessInfo.textToSpeechPermission string Liệu có chuyển văn bản sang lời nói cho âm lượng này không. Giá trị có thể là ALLOW, ALLOW_FOR_ACCESSIBILITY, hoặc NOT_ALLOW.
accessInfo.epub.isAvailable boolean Là một epub văn bản tự xuống dòng có sẵn dưới dạng phạm vi công cộng hoặc để mua. (Trong phép chiếu LITE.)
accessInfo.pdf.isAvailable boolean Là một hình ảnh pdf được quét có sẵn dưới dạng miền công cộng hoặc để mua. (Trong phép chiếu LITE.)
accessInfo.downloadAccess nested object Thông tin về các quy định hạn chế về quyền truy cập giấy phép của một tập.
accessInfo.downloadAccess.kind string Loại tài nguyên.
accessInfo.downloadAccess.volumeId string Xác định số lượng mục nhập này áp dụng.
accessInfo.downloadAccess.restricted boolean Tập này có hạn chế quyền truy cập tải xuống hay không.
accessInfo.downloadAccess.deviceAllowed boolean Nếu bị hạn chế thì người dùng có được cấp quyền truy cập đối với nội dung này hay không (người dùng, thiết bị, âm lượng).
accessInfo.downloadAccess.justAcquired boolean Nếu deviceAllowed, có phải bạn vừa có được quyền truy cập khi thực hiện yêu cầu này hay không.
accessInfo.downloadAccess.maxDownloadDevices integer Nếu bị giới hạn, số lượng giấy phép tải xuống nội dung tối đa của tập 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 lấy (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ỉ tải xuống quyền truy cập 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 quyền truy cập và xác thực ứng dụng.
accessInfo.downloadAccess.reasonCode string Mã lý do cảnh báo/lỗi. 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_USED_LATE_ACCESS
accessInfo.downloadAccess.message string Thông báo lỗi/cảnh báo.
accessInfo.downloadAccess.signature string Chữ ký của phản hồi.
searchInfo object Thông tin kết quả tìm kiếm có liên quan đến số lượng này.
searchInfo.textSnippet string Một đoạn văn bản chứa truy vấn tìm kiếm.