Mylibrary.books.volumes: danh sách
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Lấy thông tin về số lượng sách cho các cuốn sách trên giá sách.
Thử ngay.
Yêu cầu
Yêu cầu HTTP
GET https://www.googleapis.com/books/v1/mylibrary/bookshelves/shelf/volumes
Thông số
Tên thông số |
Giá trị |
Mô tả |
Thông số bắt buộc |
shelf |
string |
Mã nhận dạng hoặc tên của giá sách để truy xuất các tập.
|
Thông số tuỳ chọn |
maxResults |
unsigned integer |
Số kết quả tối đa cần trả về
|
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.
|
q |
string |
Chuỗi truy vấn tìm kiếm toàn bộ văn bản trong kệ sách này.
|
showPreorders |
boolean |
Đặt thành true để hiển thị sách đã đặ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 phần tử đầ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ề một phần nội dung phản hồi có cấu trúc sau:
{
"kind": "books#volumes",
"totalItems": integer,
"items": [
volumes Resource
]
}
Tên thuộc tính |
Giá trị |
Mô tả |
Ghi chú |
kind |
string |
Loại tài nguyên. |
|
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 tập được trả về trong phản hồi này nếu kết quả đã được phân trang. |
|
items[] |
list |
Danh sách các phương tiện. |
|
Thử ngay!
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.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2024-11-08 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2024-11-08 UTC."],[[["\u003cp\u003eRetrieves volume information for books on a specific bookshelf.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by search query, pre-orders, and selected fields.\u003c/p\u003e\n"],["\u003cp\u003eReturns a list of volumes with details like total items and individual volume resources.\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination for handling large results.\u003c/p\u003e\n"],["\u003cp\u003eCan be tested using the provided interactive explorer.\u003c/p\u003e\n"]]],[],null,["# Mylibrary.bookshelves.volumes: list\n\nGets volume information for volumes on a bookshelf.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP Request\n\n```\nGET https://www.googleapis.com/books/v1/mylibrary/bookshelves/shelf/volumes\n```\n\n### Parameters\n\n| Parameter Name | Value | Description |\n|-----------------|--------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Required Parameters** |||\n| `shelf` | `string` | The bookshelf ID or name retrieve volumes for. |\n| **Optional Parameters** |||\n| `maxResults` | `unsigned integer` | Maximum number of results to return |\n| `projection` | `string` | Restrict information returned to a set of selected fields. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`full`\" - Includes all volume data. - \"`lite`\" - Includes a subset of fields in volumeInfo and accessInfo. |\n| `q` | `string` | Full-text search query string in this bookshelf. |\n| `showPreorders` | `boolean` | Set to true to show pre-ordered books. Defaults to false. |\n| `source` | `string` | String to identify the originator of this request. |\n| `startIndex` | `unsigned integer` | Index of the first element to return (starts at 0) |\n\n### Request Body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```objective-c\n{\n \"kind\": \"books#volumes\",\n \"totalItems\": integer,\n \"items\": [\n volumes Resource\n ]\n}\n```\n\n| Property Name | Value | Description | Notes |\n|---------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `kind` | `string` | Resource type. | |\n| `totalItems` | `integer` | Total number of volumes found. This might be greater than the number of volumes returned in this response if results have been paginated. | |\n| `items[]` | `list` | A list of volumes. | |\n\nTry It!\n-------\n\n\nUse the explorer below to call this method on live data and see the response."]]