คอลเล็กชัน
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 |
ลิงก์รูปภาพสำหรับขนาดใหญ่พิเศษ (กว้างประมาณ 1280 พิกเซล) (ในการฉายภาพ 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, FREE, NOT_FOR_SALE หรือ FOR_PREORDER | |
saleInfo.isEbook |
boolean |
หนังสือเล่มนี้เป็น eBook หรือไม่ (เพิ่มลงในชั้นวาง "eBooks ของฉัน") | |
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_PUBLIC_DOMAIN, SAMPLE หรือ NONE (ในการฉายภาพ LITE) | |
accessInfo.embeddable |
boolean |
ฝังวอลุ่มนี้ในวิวพอร์ตได้โดยใช้ Embedded Viewer API หรือไม่ | |
accessInfo.publicDomain |
boolean |
หนังสือนี้เป็นสาธารณสมบัติในประเทศที่ระบุไว้ข้างต้นหรือไม่ | |
|
string |
URL สำหรับดูข้อมูลเกี่ยวกับเล่มนี้ในเว็บไซต์ Google Books (ในการฉายภาพ Lite) | |
userInfo.updated |
datetime |
การประทับเวลาที่ผู้ใช้แก้ไขเล่มนี้ครั้งล่าสุด เช่น การอัปเดตตําแหน่งการอ่าน การซื้อเล่ม หรือเขียนรีวิว (รูปแบบวันที่และเวลา UTC ของ RFC 3339) | |
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 |
หาก deviceAllowed แสดงว่าเพิ่งได้รับสิทธิ์เข้าถึงจากคำขอนี้ | |
accessInfo.downloadAccess.maxDownloadDevices |
integer |
จำนวนใบอนุญาตการดาวน์โหลดเนื้อหาสูงสุดหากมีการจำกัดไว้สำหรับเล่มนี้ | |
accessInfo.downloadAccess.downloadsAcquired |
integer |
หากมีการจํากัด จํานวนใบอนุญาตการดาวน์โหลดเนื้อหาที่ได้รับแล้ว (รวมถึงไคลเอ็นต์ที่ขอ หากได้รับอนุญาต) | |
accessInfo.downloadAccess.nonce |
string |
Client Nonce สำหรับการยืนยัน สิทธิ์การดาวน์โหลดและการตรวจสอบไคลเอ็นต์เท่านั้น | |
accessInfo.downloadAccess.source |
string |
ตัวระบุแอปไคลเอ็นต์สำหรับการยืนยัน สิทธิ์เข้าถึงการดาวน์โหลดและการตรวจสอบไคลเอ็นต์เท่านั้น | |
accessInfo.downloadAccess.reasonCode |
string |
รหัสเหตุผลของข้อผิดพลาด/คำเตือน ทั้งนี้อาจมีการเพิ่มรหัสอื่นๆ ในอนาคต 0 OK 100 ACCESS_DENIED_PUBLISHER_LIMIT 101 ACCESS_DENIED_LIMIT 200 WARNING_USED_LAST_ACCESS | |
accessInfo.downloadAccess.message |
string |
ข้อความแสดงข้อผิดพลาด/คําเตือน | |
accessInfo.downloadAccess.signature |
string |
ลายเซ็นการตอบกลับ | |
searchInfo |
object |
ข้อมูลผลการค้นหาที่เกี่ยวข้องกับปริมาณนี้ | |
searchInfo.textSnippet |
string |
ตัวอย่างข้อความที่มีคำค้นหา |