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.listbooks.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) | |
selfLink |
string |
URL đến tài nguyên này. (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 |
object |
Danh sách đường liên kết của hình ảnh cho tất cả kích thước có sẵn. (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. | |
volumeInfo.previewLink |
string |
URL để xem trước tập này trên trang web Google Sách. | |
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.) | |
saleInfo.buyLink |
string |
URL để mua tập này trên trang web của Google Sách. (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.epub.downloadLink |
string |
URL để tải epub xuống. (Trong phép chiếu LITE.) | |
accessInfo.epub.acsTokenLink |
string |
URL để truy xuất mã thông báo ACS cho mục đích tải xuống 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.pdf.downloadLink |
string |
URL để tải tệp pdf xuống. (Trong phép chiếu LITE.) | |
accessInfo.pdf.acsTokenLink |
string |
URL để truy xuất mã thông báo ACS để tải tệp pdf xuống. (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. | |
|
string |
URL để xem thông tin về tập này trên trang web của Google Sách. (Trong phép chiếu LITE) | |
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). | |
volumeInfo.canonicalVolumeLink |
string |
URL chính tắc cho một tập. (Trong phép chiếu LITE.) | |
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.webReaderLink |
string |
URL để đọc tập này trên trang web của Google Sách. Đường liên kết sẽ không cho phép người dùng đọc các tập không thể xem. | |
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. |