Khối 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}

Các tham số

Tên thông số Giá trị Mô tả
Các 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.
Các thông 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 với 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 với khả năng xem văn bản ở mức tối đa.
  • "full" – Công khai có thể xem toàn bộ văn bản âm lượng.
  • "paid-ebooks" – Sách điện tử trên Google có cung cấp 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ả trong phạm vi sách với 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" – Hạn chế đối với thư viện của người dùng, bất kỳ giá sách 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ố lượng kết quả tối đa cần trả về. Giá trị được chấp nhận là từ 0 đến 40, bao gồm cả hai giá trị này.
orderBy string Sắp xếp kết quả tìm kiếm.

Các giá trị được chấp nhận là:
  • "newest" – Phát hành gần đây nhất.
  • "relevance" – Mức độ liên quan đến cụm từ tìm kiếm.
partner string Hạn chế và đưa ra 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 âm 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 tập hợp các trường được chọn.

Các giá trị được chấp nhận là:
  • "full" – Bao gồm tất cả dữ liệu âm 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 đúng để hiển thị các sách có thể đặt trước. Giá trị mặc định là sai.
source string Chuỗi để xác định nguồn gốc của yêu cầu này.
startIndex unsigned integer Chỉ mục của kết quả đầu tiê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 với cấu trúc sau:

{
  "kind": "books#volumes",
  "items": [
    volume Resource
  ],
  "totalItems": (value)
}
Tên tài sản Giá trị 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 thấy. Số lượng này có thể lớn hơn số lượng phương thức trả về trong phản hồi này nếu kết quả được phân trang.

Hãy thử xem!

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