หน้านี้ได้รับการแปลโดย Cloud Translation API

ระดับเสียง

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

วิธีการ

เมธอดต่อไปนี้จะใช้กับข้อมูลสาธารณะเกี่ยวกับวอลุ่ม และไม่จำเป็นต้องมีการตรวจสอบสิทธิ์

books.volumes.list

books.volumes.get

วิธีการต่อไปนี้จะใช้กับมุมมอง "คลังของฉัน" ของระดับเสียงส่วนตัวและต้องมีการตรวจสอบสิทธิ์

books.mylibrary.bookshelves.volumes.list

books.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 หนังสือ
`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`	หนังสือเล่มนี้เป็นสาธารณสมบัติในประเทศที่ระบุไว้ข้างต้นหรือไม่
`volumeInfo.infoLink`	`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`	ตัวอย่างข้อความที่มีคำค้นหา