ระดับเสียง

คอลเล็กชัน Volume ใช้เพื่อค้นหาหรือแสดงเนื้อหาของชั้นวางหนังสือ คอลเล็กชันนี้เป็นคอลเล็กชันแบบอ่านอย่างเดียว

เมธอด

เมธอดต่อไปนี้จะใช้กับข้อมูลสาธารณะเกี่ยวกับวอลุ่ม และไม่จำเป็นต้องมีการตรวจสอบสิทธิ์
books.volumes.list
books.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)
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.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 หมวดหมู่หลักของหนังสือเล่มนี้ โดยจะเป็นหมวดหมู่จากรายการหมวดหมู่ที่แสดงด้านล่างซึ่งมีน้ำหนักมากที่สุด
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)
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.pdf object ข้อมูลเกี่ยวกับเนื้อหา PDF (ในการฉายภาพ Lite)
accessInfo.accessViewStatus string รวมสิทธิ์เข้าถึงและการแสดงผลของวอลุ่มนี้ไว้ในช่องสถานะเดียวสําหรับผู้ใช้รายนี้ ค่าที่เป็นไปได้คือ FULL_PURCHASED, FULL_PUBLIC_DOMAIN, SAMPLE หรือ NONE (ในการฉายภาพ LITE)
accessInfo.embeddable boolean ฝังวอลุ่มนี้ในวิวพอร์ตได้โดยใช้ Embedded Viewer API หรือไม่
accessInfo.publicDomain boolean หนังสือนี้เป็นสาธารณสมบัติในประเทศที่ระบุไว้ข้างต้นหรือไม่
userInfo.updated datetime การประทับเวลาที่ผู้ใช้แก้ไขเล่มนี้ครั้งล่าสุด เช่น การอัปเดตตําแหน่งการอ่าน การซื้อเล่ม หรือเขียนรีวิว (รูปแบบวันที่และเวลา UTC ของ RFC 3339)
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.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 ตัวอย่างข้อความที่มีคำค้นหา