Bookshelves.volumes: รายการ
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
ดึงข้อมูลเล่มในชั้นวางหนังสือที่เฉพาะเจาะจงสำหรับผู้ใช้ที่ระบุ
ลองใช้เลย
ส่งคำขอ
คำขอ HTTP
GET https://www.googleapis.com/books/v1/users/userId/bookshelves/shelf/volumes
พารามิเตอร์
ชื่อพารามิเตอร์ |
ค่า |
คำอธิบาย |
พารามิเตอร์ที่จำเป็น |
shelf |
string |
รหัสของชั้นวางหนังสือสำหรับเรียกดูชุด
|
userId |
string |
รหัสของผู้ใช้ที่จะดึงข้อมูลเล่มในชั้นวาง
|
พารามิเตอร์ที่ไม่บังคับ |
maxResults |
unsigned integer |
จำนวนผลลัพธ์สูงสุดที่จะแสดง
|
showPreorders |
boolean |
ตั้งค่าเป็น "จริง" เพื่อแสดงหนังสือที่สั่งจองล่วงหน้า ค่าเริ่มต้นคือ False
|
source |
string |
สตริงเพื่อระบุผู้ส่งคำขอนี้
|
startIndex |
unsigned integer |
ดัชนีขององค์ประกอบแรกที่แสดงผล (เริ่มต้นที่ 0)
|
เนื้อความของคำขอ
อย่าระบุเนื้อหาคำขอด้วยเมธอดนี้
คำตอบ
หากทำสำเร็จ วิธีการนี้จะแสดงผลลัพธ์เป็นเนื้อหาการตอบกลับซึ่งมีโครงสร้างดังต่อไปนี้
{
"kind": "books#volumes",
"totalItems": integer,
"items": [
volumes Resource
]
}
ชื่อพร็อพเพอร์ตี้ |
ค่า |
คำอธิบาย |
หมายเหตุ |
kind |
string |
ประเภททรัพยากร |
|
totalItems |
integer |
จํานวนเล่มทั้งหมดที่พบ ซึ่งอาจมากกว่าจำนวนเล่มที่แสดงในการตอบกลับนี้หากมีการแบ่งหน้าผลลัพธ์ |
|
items[] |
list |
รายการเล่ม |
|
ลองเลย
ใช้เครื่องมือสำรวจด้านล่างเพื่อเรียกใช้เมธอดนี้กับข้อมูลที่เผยแพร่อยู่และดูการตอบกลับ
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2024-11-08 UTC
[null,null,["อัปเดตล่าสุด 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."]]