Bookshelves.volume: 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.
Truy xuất các tập trong một giá sách cụ thể cho người dùng đã chỉ định.
Thử ngay.
Yêu cầu
Yêu cầu HTTP
GET https://www.googleapis.com/books/v1/users/userId/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 của giá sách để truy xuất các tập sách.
|
userId |
string |
Mã nhận dạng của người dùng cần truy xuất các cuốn sách trên kệ sách.
|
Thông số tuỳ chọn |
maxResults |
unsigned integer |
Số kết quả tối đa cần trả về
|
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
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ề 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ố 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. |
|
items[] |
list |
Danh sách các phương tiện. |
|
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.
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 a list of books from a specific bookshelf belonging to a given user.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by parameters such as maximum results, pre-orders, and starting index for pagination.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes the total number of books found and a list of book details.\u003c/p\u003e\n"],["\u003cp\u003eYou can interactively try this method using the provided explorer to test it with live data.\u003c/p\u003e\n"]]],[],null,["# Bookshelves.volumes: list\n\nRetrieves volumes in a specific bookshelf for the specified user.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP Request\n\n```\nGET https://www.googleapis.com/books/v1/users/userId/bookshelves/shelf/volumes\n```\n\n### Parameters\n\n| Parameter Name | Value | Description |\n|-----------------|--------------------|-----------------------------------------------------------|\n| **Required Parameters** |||\n| `shelf` | `string` | ID of bookshelf to retrieve volumes. |\n| `userId` | `string` | ID of user for whom to retrieve bookshelf volumes. |\n| **Optional Parameters** |||\n| `maxResults` | `unsigned integer` | Maximum number of results to return |\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."]]