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

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

ส่งคำขอ

คำขอ 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 ที่มองเห็นข้อความได้เต็มปริมาณ
  • "full" - บุคคลทั่วไปดูข้อความทั้งเล่มได้
  • "paid-ebooks" - eBook ของ Google ที่มีราคา
  • "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 ตั้งค่าเป็น "จริง" เพื่อแสดงหนังสือที่พร้อมให้สั่งจองล่วงหน้า ค่าเริ่มต้นคือ False
source string สตริงเพื่อระบุผู้ส่งคำขอนี้
startIndex unsigned integer ดัชนีของผลลัพธ์แรกที่แสดง (เริ่มต้นที่ 0)

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

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

คำตอบ

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

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

ลองเลย

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