ใช้คอลเล็กชัน
Volume
เพื่อค้นหาหรือแสดงเนื้อหาของชั้นวางหนังสือ คอลเล็กชันนี้เป็นคอลเล็กชันแบบอ่านอย่างเดียววิธีการ
วิธีการต่อไปนี้ใช้กับข้อมูลสาธารณะเกี่ยวกับปริมาณและไม่จําเป็นต้องมีการตรวจสอบสิทธิ์
books.volumes.listbooks.volumes.get
วิธีการต่อไปนี้ใช้ได้กับมุมมองปริมาณ "คลังของฉัน" ส่วนตัวและต้องมีการตรวจสอบสิทธิ์
books.mylibrary.bookshelves.volumes.list- รับ
- เรียกข้อมูลทรัพยากรระดับเสียงตามรหัส
- list
- ทําการค้นหาหนังสือ
การนําเสนอแหล่งข้อมูล
วอลุ่มแสดงถึงข้อมูลที่ Google Books โฮสต์เกี่ยวกับหนังสือหรือนิตยสาร ซึ่งประกอบด้วยข้อมูลเมตา เช่น ชื่อหนังสือและผู้แต่ง รวมถึงข้อมูลที่ปรับเปลี่ยนในแบบของคุณ เช่น ซื้อแล้วหรือยัง (โปรดดูช่องระดับเสียงที่ฉายใน LITE ได้ที่ด้านล่าง)
{ "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 } }
ชื่อพร็อพเพอร์ตี้ | ค่า | คำอธิบาย | หมายเหตุ |
---|---|---|---|
kind |
string |
ประเภททรัพยากรสําหรับวอลุ่ม (ในการฉายภาพ LITE) | |
id |
string |
ตัวระบุที่ไม่ซ้ํากันสําหรับวอลุ่ม (ในการฉายภาพ LITE) | |
etag |
string |
ตัวระบุที่คลุมเครือสําหรับทรัพยากรระดับเสียงเวอร์ชันที่เจาะจง (ในการฉายภาพ LITE) | |
selfLink |
string |
URL ไปยังทรัพยากรนี้ (ในการฉายภาพ LITE) | |
volumeInfo |
object |
ข้อมูลปริมาณทั่วไป | |
volumeInfo.title |
string |
ชื่อระดับเสียง (ในการฉายภาพ LITE) | |
volumeInfo.subtitle |
string |
ชื่อรองของระดับเสียง (ในการฉายภาพ LITE) | |
volumeInfo.authors[] |
list |
ชื่อผู้แต่งและ/หรือบรรณาธิการของเล่มนี้ (ในการฉายภาพ LITE) | |
volumeInfo.publisher |
string |
ผู้เผยแพร่หนังสือเล่มนี้ (ในการฉายภาพ LITE) | |
volumeInfo.publishedDate |
string |
วันที่เผยแพร่ (ในการฉายภาพ LITE) | |
volumeInfo.description |
string |
ข้อมูลสรุปเกี่ยวกับปริมาณ ข้อความของคําอธิบายจะอยู่ในรูปแบบ HTML และมีองค์ประกอบการจัดรูปแบบง่ายๆ เช่น แท็ก b, i และ br (ในการฉายภาพ LITE) | |
volumeInfo.industryIdentifiers[] |
list |
ตัวระบุมาตรฐานอุตสาหกรรมสําหรับปริมาณนี้ | |
volumeInfo.industryIdentifiers[].type |
string |
ประเภทตัวระบุ ค่าที่เป็นไปได้ ได้แก่ ISBN_10, ISBN_13, ISSN และ OTHER | |
volumeInfo.industryIdentifiers[].identifier |
string |
ตัวระบุปริมาณเฉพาะอุตสาหกรรม | |
volumeInfo.pageCount |
integer |
จํานวนหน้าทั้งหมด | |
volumeInfo.dimensions |
object |
ขนาดทางกายภาพของระดับเสียงนี้ | |
volumeInfo.dimensions.height |
string |
ความสูงหรือความยาวของระดับเสียงนี้ (เป็นซม.) | |
volumeInfo.dimensions.width |
string |
ความกว้างของระดับเสียงนี้ (เป็นซม.) | |
volumeInfo.dimensions.thickness |
string |
ความหนาของระดับเสียงนี้ (เป็นซม.) | |
volumeInfo.printType |
string |
ประเภทการเผยแพร่หนังสือเล่มนี้ ค่าที่เป็นไปได้คือ BOOK หรือ MAGAZINE | |
volumeInfo.categories[] |
list |
รายการหมวดหมู่ เช่น "นิยาย" "สืบสวน" | |
volumeInfo.averageRating |
double |
คะแนนเฉลี่ยรีวิวของวอลุ่มนี้ (ต่ําสุด = 1.0, สูงสุด = 5.0) | |
volumeInfo.ratingsCount |
integer |
จํานวนการให้คะแนนรีวิวสําหรับปริมาณนี้ | |
volumeInfo.contentVersion |
string |
ตัวระบุสําหรับเวอร์ชันของเนื้อหาวอลุ่ม (ข้อความและรูปภาพ) (ในการฉายภาพ LITE) | |
volumeInfo.imageLinks |
object |
รายการลิงก์รูปภาพสําหรับขนาดทั้งหมดที่ใช้ได้ (ในการฉายภาพ LITE) | |
volumeInfo.imageLinks.thumbnail |
string |
ลิงก์รูปภาพสําหรับขนาดภาพขนาดย่อ (กว้างประมาณ 128 พิกเซล) (ในการฉายภาพ LITE) | |
volumeInfo.imageLinks.small |
string |
ลิงก์รูปภาพสําหรับขนาดเล็ก (กว้างประมาณ 300 พิกเซล) (ในการฉายภาพ LITE) | |
volumeInfo.imageLinks.medium |
string |
ลิงก์รูปภาพสําหรับขนาดกลาง (กว้างประมาณ 575 พิกเซล) (ในการฉายภาพ LITE) | |
volumeInfo.imageLinks.large |
string |
ลิงก์รูปภาพสําหรับขนาดใหญ่ (ความกว้างประมาณ 800 พิกเซล) (ในการฉายภาพ LITE) | |
volumeInfo.imageLinks.smallThumbnail |
string |
ลิงก์รูปภาพสําหรับภาพขนาดย่อขนาดเล็ก (ความกว้างประมาณ 80 พิกเซล) (ในการฉายภาพ LITE) | |
volumeInfo.imageLinks.extraLarge |
string |
ลิงก์รูปภาพสําหรับขนาดใหญ่พิเศษ (กว้างประมาณ 1,280 พิกเซล) (ในการฉายภาพ LITE) | |
volumeInfo.language |
string |
ภาษาที่เหมาะสมที่สุดสําหรับปริมาณนี้ (อิงตามเนื้อหา) ซึ่งเป็นรหัส ISO 639-1 แบบ 2 ตัวอักษร เช่น "fr", "en" เป็นต้น | |
volumeInfo.mainCategory |
string |
หมวดหมู่หลักที่มีปริมาณปริมาณนี้ โดยจะเป็นหมวดหมู่จากรายการหมวดหมู่ที่แสดงด้านล่างซึ่งมีน้ําหนักสูงสุด | |
volumeInfo.previewLink |
string |
URL เพื่อดูตัวอย่างของหนังสือเล่มนี้ในเว็บไซต์ Google Books | |
userInfo |
object |
ข้อมูลเฉพาะที่เกี่ยวข้องกับวอลุ่มนี้ (เช่น หน้าเว็บที่ผู้ใช้รายนี้อ่านล่าสุดหรือซื้อหนังสือเล่มนี้) | |
userInfo.review |
nested object |
รีวิวระดับเสียงของผู้ใช้รายนี้ (หากมี) | |
userInfo.readingPosition |
readingPosition Resource |
ระดับการอ่านในปัจจุบันของผู้ใช้ในระดับเสียง หากมี (ในการฉายภาพ LITE) | |
userInfo.isPurchased |
boolean |
ผู้ใช้ที่ตรวจสอบสิทธิ์ซึ่งส่งคําขอซื้อนี้เป็นวอลุ่มนี้หรือไม่ (ในการฉายภาพ LITE) | |
saleInfo |
object |
ข้อมูลเกี่ยวกับปริมาณที่เกี่ยวข้องกับ eBookstore และ/หรือการซื้อได้ ข้อมูลนี้อาจขึ้นอยู่กับประเทศที่เกิดคําขอ (เช่น หนังสืออาจไม่วางจําหน่ายในบางประเทศ) | |
saleInfo.country |
string |
รหัสประเทศตามมาตรฐาน ISO_3166-1 แบบ 2 ตัวอักษรที่ข้อมูลการลดราคานี้ถูกต้อง (ในการฉายภาพ LITE) | |
saleInfo.saleability |
string |
หนังสือเล่มนี้มีขายหรือนําเสนอฟรีใน Google eBookstore สําหรับประเทศที่ระบุไว้ด้านบนหรือไม่ ค่าที่เป็นไปได้คือ FOR_SALE, ฟรี, NOT_FOR_SALE หรือ FOR_PREORDER | |
saleInfo.isEbook |
boolean |
หนังสือเล่มนี้เป็น eBook ไหม (สามารถเพิ่มลงในชั้นวาง eBook ได้) | |
saleInfo.listPrice |
object |
ราคาขายปลีกแนะนํา (ในการฉายภาพ LITE) | |
saleInfo.listPrice.amount |
double |
จํานวนเงินในสกุลเงินที่ระบุไว้ด้านล่าง (ในการฉายภาพ LITE) | |
saleInfo.listPrice.currencyCode |
string |
รหัสสกุลเงิน 3 ตัวอักษรตามมาตรฐาน ISO 4217 (ในการฉายภาพ LITE) | |
saleInfo.retailPrice |
object |
ราคาขายจริงของหนังสือ ราคานี้เท่ากับราคาขายปลีกหรือขายปลีกที่แนะนํา เว้นแต่ว่าจะมีข้อเสนอหรือส่วนลดสําหรับปริมาณนี้ (ในการฉายภาพ LITE) | |
saleInfo.retailPrice.amount |
double |
จํานวนเงินในสกุลเงินที่ระบุไว้ด้านล่าง (ในการฉายภาพ LITE) | |
saleInfo.retailPrice.currencyCode |
string |
รหัสสกุลเงิน 3 ตัวอักษรตามมาตรฐาน ISO 4217 (ในการฉายภาพ LITE) | |
saleInfo.buyLink |
string |
URL สําหรับซื้อหนังสือเล่มนี้ในเว็บไซต์ Google Books (ในการฉายภาพ LITE) | |
accessInfo |
object |
ข้อมูลเกี่ยวกับระดับเสียงที่เกี่ยวข้องกับการอ่านหรือการรับข้อความปริมาณ ข้อมูลนี้อาจขึ้นอยู่กับประเทศ (หนังสืออาจเป็นสาธารณสมบัติในประเทศหนึ่งแต่ไม่ใช่ในอีกประเทศหนึ่ง) | |
accessInfo.country |
string |
รหัสประเทศตามมาตรฐาน ISO_3166-1 แบบ 2 ตัวอักษรที่ข้อมูลการเข้าถึงนี้ถูกต้อง (ในการฉายภาพ LITE) | |
accessInfo.viewability |
string |
การเข้าถึงการอ่านวอลุ่ม ค่าที่เป็นไปได้คือ PARTIAL, ALL_PAGES, NO_PAGES หรือ UNKNOWN ค่านี้ขึ้นอยู่กับประเทศในรายการด้านบน ค่า PARTIAL นั้นหมายความว่าผู้จัดพิมพ์อนุญาตให้ดูวอลุ่มบางส่วนได้แบบสาธารณะโดยไม่มีการซื้อ ข้อกําหนดนี้รวมถึง eBook และไม่ใช่ eBook หนังสือที่เป็นสาธารณสมบัติจะมีค่าเป็น ALL_PAGES เสมอ | |
accessInfo.epub |
object |
ข้อมูลเกี่ยวกับเนื้อหา epub (ในการฉายภาพ LITE) | |
accessInfo.epub.downloadLink |
string |
URL สําหรับดาวน์โหลด epub (ในการฉายภาพ LITE) | |
accessInfo.epub.acsTokenLink |
string |
URL เพื่อเรียกดูโทเค็น ACS สําหรับการดาวน์โหลด epub (ในการฉายภาพ LITE) | |
accessInfo.pdf |
object |
ข้อมูลเกี่ยวกับเนื้อหา PDF (ในการฉายภาพ LITE) | |
accessInfo.pdf.downloadLink |
string |
URL สําหรับดาวน์โหลด PDF (ในการฉายภาพ LITE) | |
accessInfo.pdf.acsTokenLink |
string |
URL สําหรับเรียกโทเค็น ACS สําหรับการดาวน์โหลด PDF (ในการฉายภาพ LITE) | |
accessInfo.accessViewStatus |
string |
รวมการเข้าถึงและความสามารถในการแสดงตัวโฆษณาของปริมาณนี้เป็นช่องสถานะเดียวสําหรับผู้ใช้รายนี้ ค่าอาจเป็น FULL_PURCHASED, FULL_COMMUNITY_DOMAIN, SAMPLE หรือ NONE (ในการฉายภาพ LITE) | |
accessInfo.embeddable |
boolean |
ฝังเนื้อหานี้ในวิวพอร์ตโดยใช้ API ผู้ดูแบบฝังได้หรือไม่ | |
accessInfo.publicDomain |
boolean |
หนังสือเล่มนี้เป็นสาธารณสมบัติในประเทศที่ระบุไว้ด้านบนหรือไม่ | |
|
string |
URL เพื่อดูข้อมูลเกี่ยวกับหนังสือเล่มนี้ในเว็บไซต์ Google Books (ในการฉายภาพ LITE) | |
userInfo.updated |
datetime |
การประทับเวลาที่มีการแก้ไขปริมาณนี้โดยการดําเนินการของผู้ใช้ครั้งล่าสุด เช่น การอัปเดตตําแหน่งการอ่าน การซื้อปริมาณ หรือการเขียนรีวิว (รูปแบบวันที่และเวลา RFC 3339 UTC) | |
volumeInfo.canonicalVolumeLink |
string |
Canonical URL สําหรับวอลุ่ม (ในการฉายภาพ LITE) | |
userInfo.isPreordered |
boolean |
ผู้ใช้ที่สั่งซื้อล่วงหน้าซึ่งส่งคําขอนี้จะสั่งจองหนังสือเล่มนี้ล่วงหน้าหรือไม่ (ในการฉายภาพ LITE) | |
saleInfo.onSaleDate |
datetime |
วันที่หนังสือเล่มนี้พร้อมจําหน่าย | |
accessInfo.textToSpeechPermission |
string |
อนุญาตให้ใช้การอ่านออกเสียงข้อความสําหรับระดับเสียงนี้หรือไม่ ค่าอาจเป็น Allowed, Allowed_FOR_ACCESSIBILITY หรือ NOT_Allowed | |
accessInfo.epub.isAvailable |
boolean |
เป็น epub ข้อความต่อเนื่องที่พร้อมใช้งานเป็นสาธารณสมบัติหรือสามารถซื้อได้ (ในการฉายภาพ LITE) | |
accessInfo.pdf.isAvailable |
boolean |
เป็นไฟล์ PDF รูปภาพที่สแกนเป็นสาธารณสมบัติหรือซื้อ (ในการฉายภาพ LITE) | |
accessInfo.webReaderLink |
string |
URL เพื่ออ่านหนังสือเล่มนี้ในเว็บไซต์ Google Books ลิงก์จะไม่อนุญาตให้ผู้ใช้อ่านวอลุ่มที่มองเห็นได้ | |
accessInfo.downloadAccess |
nested object |
ข้อมูลเกี่ยวกับข้อจํากัดในการเข้าถึงใบอนุญาตการดาวน์โหลดของวอลุ่ม | |
accessInfo.downloadAccess.kind |
string |
ประเภททรัพยากร | |
accessInfo.downloadAccess.volumeId |
string |
ระบุปริมาณที่เกี่ยวข้องกับรายการนี้ | |
accessInfo.downloadAccess.restricted |
boolean |
ระดับเสียงนี้มีข้อจํากัดในการดาวน์โหลดหรือไม่ | |
accessInfo.downloadAccess.deviceAllowed |
boolean |
หากจํากัดว่าจะได้รับสิทธิ์เข้าถึงนี้หรือไม่ (ผู้ใช้ อุปกรณ์ ระดับเสียง) | |
accessInfo.downloadAccess.justAcquired |
boolean |
หากอุปกรณ์อนุญาต การได้มาเมื่อเร็วๆ นี้มีคําขอหรือไม่ | |
accessInfo.downloadAccess.maxDownloadDevices |
integer |
หากจํากัดไว้ จํานวนใบอนุญาตดาวน์โหลดเนื้อหาสูงสุดสําหรับปริมาณนี้ | |
accessInfo.downloadAccess.downloadsAcquired |
integer |
หากจํากัดไว้ จํานวนใบอนุญาตดาวน์โหลดเนื้อหาที่ได้รับไปแล้ว (รวมถึงไคลเอ็นต์ที่ขอหากมีใบอนุญาต) | |
accessInfo.downloadAccess.nonce |
string |
ไคลเอ็นต์รับการยืนยัน เฉพาะการดาวน์โหลดและการตรวจสอบไคลเอ็นต์เท่านั้น | |
accessInfo.downloadAccess.source |
string |
ตัวระบุแอปไคลเอ็นต์สําหรับการยืนยัน เฉพาะการดาวน์โหลดและการตรวจสอบไคลเอ็นต์เท่านั้น | |
accessInfo.downloadAccess.reasonCode |
string |
ข้อผิดพลาด/รหัสข้อผิดพลาดของคําเตือน อาจมีการเพิ่มรหัสอื่นๆ ในอนาคต 0 OK 100 ACCESS_DENIED_PUBLISHER_LIMIT 101 ACCESS_DENIED_LIMIT 200 WARNING_USE_LAST_ACCESS | |
accessInfo.downloadAccess.message |
string |
ข้อความแสดงข้อผิดพลาด/คําเตือน | |
accessInfo.downloadAccess.signature |
string |
ลายเซ็นการตอบกลับ | |
searchInfo |
object |
ข้อมูลผลการค้นหาที่เกี่ยวข้องกับปริมาณนี้ | |
searchInfo.textSnippet |
string |
ตัวอย่างข้อความที่มีคําค้นหา |