ระดับเสียง

ใช้คอลเล็กชัน 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 ลิงก์รูปภาพสําหรับขนาดใหญ่พิเศษ (กว้างประมาณ 1,280 พิกเซล) (ในการฉายภาพ 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, ฟรี, 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)
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_COMMUNITY_DOMAIN, SAMPLE หรือ NONE (ในการฉายภาพ LITE)
accessInfo.embeddable boolean ฝังเนื้อหานี้ในวิวพอร์ตโดยใช้ API ผู้ดูแบบฝังได้หรือไม่
accessInfo.publicDomain boolean หนังสือเล่มนี้เป็นสาธารณสมบัติในประเทศที่ระบุไว้ด้านบนหรือไม่
userInfo.updated datetime การประทับเวลาที่มีการแก้ไขปริมาณนี้โดยการดําเนินการของผู้ใช้ครั้งล่าสุด เช่น การอัปเดตตําแหน่งการอ่าน การซื้อปริมาณ หรือการเขียนรีวิว (รูปแบบวันที่และเวลา RFC 3339 UTC)
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 หากอุปกรณ์อนุญาต การได้มาเมื่อเร็วๆ นี้มีคําขอหรือไม่
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 ตัวอย่างข้อความที่มีคําค้นหา