Số lượng: danh sách

Tìm kiếm sách. Thử ngay.

Yêu cầu

Yêu cầu HTTP

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

Thông số

Tên thông số Giá trị Mô tả
Thông số bắt buộc
q string Chuỗi truy vấn tìm kiếm toàn bộ văn bản.
Thông số tuỳ chọn
download string Hạn chế theo số lượng theo tình trạng có thể tải xuống.

Các giá trị được chấp nhận là:
  • "epub" – Tất cả các tập có epub.
filter string Lọc kết quả tìm kiếm.

Các giá trị được chấp nhận là:
  • "ebooks" - Tất cả sách điện tử trên Google.
  • "free-ebooks" – Sách điện tử của Google có khả năng xem toàn bộ văn bản.
  • "full" – Mọi người có thể xem toàn bộ nội dung tập.
  • "paid-ebooks" - Sách điện tử trên Google có giá.
  • "partial" – Công khai có thể xem một số phần văn bản.
langRestrict string Chỉ hiển thị kết quả là những cuốn sách có mã ngôn ngữ này.
libraryRestrict string Chỉ cho phép tìm kiếm trong thư viện của người dùng này.

Các giá trị được chấp nhận là:
  • "my-library" – Chỉ cho phép truy cập vào thư viện của người dùng, bất kỳ kệ nào.
  • "no-restrict" – Không hạn chế dựa trên thư viện của người dùng.
maxResults unsigned integer Số kết quả tối đa cần trả về. Giá trị có thể chấp nhận là từ 0 đến 40.
orderBy string Sắp xếp kết quả tìm kiếm.

Các giá trị được chấp nhận là:
  • "newest" – Được xuất bản gần đây nhất.
  • "relevance" – Mức độ liên quan đến cụm từ tìm kiếm.
partner string Giới hạn và kết quả về thương hiệu cho mã đối tác.
printType string Chỉ cho phép sách hoặc tạp chí.

Các giá trị được chấp nhận là:
  • "all" – Tất cả các loại nội dung có số lượng lớn.
  • "books" – Chỉ sách.
  • "magazines" - Chỉ tạp chí.
projection string Hạn chế thông tin được trả về một tập hợp các trường đã chọn.

Các giá trị được chấp nhận là:
  • "full" – Bao gồm tất cả dữ liệu về khối lượng.
  • "lite" – Bao gồm một tập hợp con các trường trong volumeInfo và accessInfo.
showPreorders boolean Đặt thành true để hiển thị những cuốn sách có thể đặt hàng trước. Giá trị mặc định là false.
source string Chuỗi để xác định tác nhân gửi yêu cầu này.
startIndex unsigned integer Chỉ mục của kết quả đầu tiên cần trả về (bắt đầu từ 0)

Nội dung yêu cầu

Không cung cấp nội dung yêu cầu bằng phương thức này.

Phản hồi

Nếu thành công, phương thức này sẽ trả về nội dung phản hồi có cấu trúc như sau:

{
  "kind": "books#volumes",
  "items": [
    volume Resource
  ],
  "totalItems": (value)
}
Tên thuộc tính Giá trị Mô tả Ghi chú
kind string Loại tài nguyên.
items[] list Danh sách các phương tiện.
totalItems integer Tổng số tập đã tìm thấy. Số liệu này có thể lớn hơn số tập được trả về trong phản hồi này nếu kết quả đã được phân trang.

Thử ngay!

Hãy sử dụng trình khám phá bên dưới để gọi phương thức này dựa trên dữ liệu trực tiếp và xem phản hồi.