คอลเล็กชัน
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 } }
ชื่อพร็อพเพอร์ตี้ | ค่า | คำอธิบาย | Notes |
---|---|---|---|
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 หนังสือ | |
userInfo |
object |
ข้อมูลเฉพาะผู้ใช้ที่เกี่ยวข้องกับวอลุ่มนี้ (เช่น หน้าที่ผู้ใช้รายนี้อ่านล่าสุดหรือว่าซื้อหนังสือเล่มนี้หรือไม่) | |
userInfo.review |
nested object |
รีวิวหนังสือชุดนี้ของผู้ใช้ หากมี | |
userInfo.readingPosition |
readingPosition Resource |
ตำแหน่งการอ่านปัจจุบันของผู้ใช้ในระดับเสียง หากมี (ในการฉายภาพ Lite) | |
userInfo.isPurchased |
boolean |
ผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์ที่ส่งคำขอซื้อหนังสือเล่มนี้หรือไม่ (ในการฉายภาพ Lite) | |
saleInfo |
object |
ข้อมูลเกี่ยวกับหนังสือที่เกี่ยวข้องกับ eBookstore และ/หรือความสามารถในการซื้อ ข้อมูลนี้อาจขึ้นอยู่กับประเทศที่มาของคำขอ (เช่น หนังสืออาจไม่มีวางจำหน่ายในบางประเทศ) | |
saleInfo.country |
string |
รหัสประเทศ 2 ตัวอักษรตามมาตรฐาน ISO_3166-1 ที่ใช้กับข้อมูลการขายนี้ได้ (ในการฉายภาพ 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 หนังสือ (ในการฉายภาพ Lite) | |
accessInfo |
object |
ข้อมูลเกี่ยวกับเล่มที่เกี่ยวข้องกับการอ่านหรือการได้รับข้อความในเล่มนั้น ข้อมูลนี้อาจขึ้นอยู่กับประเทศ (หนังสืออาจเป็นสาธารณสมบัติในประเทศหนึ่ง แต่ไม่ใช่ในประเทศอื่น เช่น) | |
accessInfo.country |
string |
รหัสประเทศ 2 ตัวอักษรตามมาตรฐาน ISO_3166-1 ซึ่งใช้ข้อมูลการเข้าถึงนี้ได้ (ในการฉายภาพ 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 |
ฝังวอลุ่มนี้ในวิวพอร์ตโดยใช้ API ผู้ดูแบบฝังได้หรือไม่ | |
accessInfo.publicDomain |
boolean |
หนังสือเล่มนี้เป็นสาธารณสมบัติในประเทศที่ระบุไว้ข้างต้นหรือไม่ | |
|
string |
URL สำหรับดูข้อมูลเกี่ยวกับหนังสือเล่มนี้บนเว็บไซต์ Google หนังสือ (ในการฉายภาพ 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 หนังสือ ลิงก์ไม่อนุญาตให้ผู้ใช้อ่านชุดที่มองไม่เห็น | |
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 |
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 |
ตัวอย่างข้อความที่มีคำค้นหา |