คอลเล็กชัน 
Volume ใช้สำหรับค้นหาหรือแสดงเนื้อหาของชั้นวางหนังสือ คอลเล็กชันนี้เป็นคอลเล็กชันแบบอ่านอย่างเดียวเมธอด
วิธีการต่อไปนี้ใช้กับข้อมูลสาธารณะเกี่ยวกับปริมาณและไม่จําเป็นต้องตรวจสอบสิทธิ์
books.volumes.listbooks.volumes.get
  วิธีการต่อไปนี้ใช้กับมุมมอง "คลังหนังสือของฉัน" ซึ่งเป็นมุมมองส่วนตัวของวอลุ่มและต้องมีการตรวจสอบสิทธิ์
books.mylibrary.bookshelves.volumes.list- get
 - ดึงข้อมูลทรัพยากรของวอลุ่มตามรหัส
 - 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 หรือไม่ (เพิ่มลงในชั้นวาง "My 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 | 
        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 | 
        ตัวอย่างข้อความที่มีคำค้นหา |