Số lượng: danh sách

Thực hiện 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}

Tham số

Tên thông số Giá trị Nội dung mô tả
Tham số bắt buộc
q string Chuỗi truy vấn tìm kiếm toàn bộ văn bản.
Tham số không bắt buộc
download string Giới hạn số lượng theo khả năng tải xuống.

Các giá trị được chấp nhận là:
  • "epub" – Tất cả các tập có tệp 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ử trên Google có khả năng xem văn bản với số lượng đầy đủ.
  • "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 các phần của văn bản.
langRestrict string Hạn chế kết quả ở những sách có mã ngôn ngữ này.
libraryRestrict string Hạn chế 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" – Giới hạn trong 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 Hạn chế đối với 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 số lượng.
  • "books" – Chỉ sách.
  • "magazines" - Chỉ tạp chí.
projection string Hạn chế thông tin được trả về cho một nhóm các trường đã chọn.

Các giá trị được chấp nhận là:
  • "full" – Gồm tất cả dữ liệu về số 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 người khởi tạo của 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

Đừ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ị Nội dung mô tả Ghi chú
kind string Loại tài nguyên.
items[] list Danh sách các tập.
totalItems integer Tổng số tập tìm được. 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.