ระดับเสียง: รายการ

ทำการค้นหาหนังสือ ลองใช้เลย

ส่งคำขอ

คำขอ HTTP

GET https://www.googleapis.com/books/v1/volumes?q={search terms}

พารามิเตอร์

ชื่อพารามิเตอร์ ค่า คำอธิบาย
พารามิเตอร์ที่จำเป็น
q string สตริงคำค้นหาแบบข้อความเต็ม
พารามิเตอร์ที่ไม่บังคับ
download string จำกัดเฉพาะเล่มที่ต้องการดาวน์โหลด

ค่าที่ยอมรับได้ มีดังนี้
  • "epub" - หนังสือทุกเล่มที่มี epub
filter string กรองผลการค้นหา

ค่าที่ยอมรับได้ มีดังนี้
  • "ebooks" - Google eBook ทั้งหมด
  • "free-ebooks" - Google eBook ที่มีความสามารถในการดูข้อความแบบเต็มเล่ม
  • "full" - สาธารณะจะดูข้อความระดับเสียงทั้งหมดได้
  • "paid-ebooks" - Google eBook ที่ระบุราคา
  • "partial" - สาธารณะมองเห็นข้อความบางส่วน
langRestrict string จำกัดผลการค้นหาให้แสดงเฉพาะหนังสือที่มีรหัสภาษานี้
libraryRestrict string จำกัดการค้นหาไว้เฉพาะในคลังของผู้ใช้รายนี้

ค่าที่ยอมรับได้ มีดังนี้
  • "my-library" - จำกัดเฉพาะคลังของผู้ใช้และชั้นวางใดก็ได้
  • "no-restrict" - ไม่จำกัดตามคลังของผู้ใช้
maxResults unsigned integer จำนวนผลลัพธ์สูงสุดที่จะแสดง ค่าที่ยอมรับได้คือ 0 ถึง 40 (รวมค่าแรกและค่าสุดท้าย)
orderBy string จัดเรียงผลการค้นหา

ค่าที่ยอมรับได้ มีดังนี้
  • "newest" - เผยแพร่ล่าสุด
  • "relevance" - ความเกี่ยวข้องกับข้อความค้นหา
partner string จำกัดและสร้างผลลัพธ์ของแบรนด์สำหรับรหัสพาร์ทเนอร์
printType string จำกัดเฉพาะหนังสือหรือนิตยสาร

ค่าที่ยอมรับได้ มีดังนี้
  • "all" - เนื้อหาทุกประเภทที่มีระดับเสียง
  • "books" - เฉพาะหนังสือ
  • "magazines" - เฉพาะนิตยสาร
projection string จำกัดข้อมูลที่ส่งคืนไปยังชุดของช่องที่เลือก

ค่าที่ยอมรับได้ มีดังนี้
  • "full" - รวมข้อมูลวอลุ่มทั้งหมด
  • "lite" - มีช่องย่อยในVolumeInfo และ AccessInfo
showPreorders boolean ตั้งค่าเป็น "จริง" เพื่อแสดงหนังสือที่พร้อมให้สั่งจองล่วงหน้า ค่าเริ่มต้นคือ "เท็จ"
source string สตริงสำหรับระบุผู้สร้างคำขอนี้
startIndex unsigned integer ดัชนีของผลลัพธ์แรกที่จะแสดงผล (เริ่มต้นที่ 0)

เนื้อความของคำขอ

โปรดอย่าให้เนื้อหาคำขอตามวิธีการนี้

คำตอบ

หากสำเร็จ เมธอดนี้จะแสดงเนื้อหาการตอบกลับซึ่งมีโครงสร้างต่อไปนี้

{
  "kind": "books#volumes",
  "items": [
    volume Resource
  ],
  "totalItems": (value)
}
ชื่อพร็อพเพอร์ตี้ ค่า คำอธิบาย Notes
kind string ประเภททรัพยากร
items[] list รายการชุด
totalItems integer จำนวนหนังสือทั้งหมดที่พบ ซึ่งอาจมากกว่าจำนวนของวอลุ่มที่แสดงผลในคำตอบนี้หากมีการใส่เลขหน้าให้ผลการค้นหา

ลองเลย

ใช้เครื่องมือสำรวจด้านล่างเพื่อเรียกใช้เมธอดนี้กับข้อมูลที่เผยแพร่อยู่และดูการตอบกลับ