ระดับเสียง: รายการ
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
ทำการค้นหาหนังสือ
ลองใช้เลย
ส่งคำขอ
คำขอ HTTP
GET https://www.googleapis.com/books/v1/volumes?q={search terms}
พารามิเตอร์
| ชื่อพารามิเตอร์ |
ค่า |
คำอธิบาย |
| พารามิเตอร์ที่จำเป็น |
q |
string |
สตริงคำค้นหาแบบข้อความเต็ม
|
| พารามิเตอร์ที่ไม่บังคับ |
download |
string |
จำกัดเฉพาะวอลุ่มตามความพร้อมให้บริการของการดาวน์โหลด
ค่าที่ยอมรับได้ มีดังนี้
- "
epub" - หนังสือทุกเล่มที่มี epub
|
filter |
string |
กรองผลการค้นหา
ค่าที่ยอมรับมีดังนี้
- "
ebooks" - Google eBook ทั้งหมด
- "
free-ebooks" - หนังสืออิเล็กทรอนิกส์ของ Google ที่มองเห็นข้อความได้เต็มปริมาณ
- "
full" - บุคคลทั่วไปดูข้อความทั้งเล่มได้
- "
paid-ebooks" - eBook ของ Google ที่มีราคา
- "
partial" - สาธารณะดูข้อความได้บางส่วน
|
langRestrict |
string |
จำกัดผลการค้นหาเฉพาะหนังสือที่มีรหัสภาษานี้
|
libraryRestrict |
string |
จำกัดการค้นหาเฉพาะในคลังเพลงของผู้ใช้รายนี้
ค่าที่ยอมรับมีดังนี้
- "
my-library" - จำกัดให้เฉพาะคลังผู้ใช้ ชั้นวางใดก็ได้
- "
no-restrict" - อย่าจำกัดตามคลังเพลงของผู้ใช้
|
maxResults |
unsigned integer |
จำนวนผลลัพธ์สูงสุดที่จะแสดง
ค่าที่ยอมรับได้คือ 0 ถึง 40 (รวมค่าแรกและค่าสุดท้าย)
|
orderBy |
string |
จัดเรียงผลการค้นหา
ค่าที่ยอมรับมีดังนี้
- "
newest" - เผยแพร่ล่าสุด
- "
relevance" - ความเกี่ยวข้องกับข้อความค้นหา
|
partner |
string |
จำกัดและติดแบรนด์ผลลัพธ์สำหรับรหัสพาร์ทเนอร์
|
printType |
string |
จำกัดเฉพาะหนังสือหรือนิตยสาร
ค่าที่ยอมรับมีดังนี้
- "
all" - เนื้อหาทุกประเภทที่มีปริมาณ
- "
books" - เฉพาะหนังสือ
- "
magazines" - เฉพาะนิตยสาร
|
projection |
string |
จำกัดข้อมูลที่แสดงผลเป็นชุดช่องที่เลือก
ค่าที่ยอมรับมีดังนี้
- "
full" - รวมข้อมูลปริมาณทั้งหมด
- "
lite" - รวมชุดย่อยของฟิลด์ใน volumeInfo และ accessInfo
|
showPreorders |
boolean |
ตั้งค่าเป็น "จริง" เพื่อแสดงหนังสือที่พร้อมให้สั่งจองล่วงหน้า ค่าเริ่มต้นคือ False
|
source |
string |
สตริงเพื่อระบุผู้ส่งคำขอนี้
|
startIndex |
unsigned integer |
ดัชนีของผลลัพธ์แรกที่แสดง (เริ่มต้นที่ 0)
|
เนื้อความของคำขอ
โปรดอย่าให้เนื้อหาคำขอด้วยวิธีนี้
คำตอบ
หากทำสำเร็จ วิธีการนี้จะแสดงผลลัพธ์เป็นเนื้อหาการตอบกลับซึ่งมีโครงสร้างดังต่อไปนี้
{
"kind": "books#volumes",
"items": [
volume Resource
],
"totalItems": (value)
}
| ชื่อพร็อพเพอร์ตี้ |
ค่า |
คำอธิบาย |
หมายเหตุ |
kind |
string |
ประเภททรัพยากร |
|
items[] |
list |
รายการเล่ม |
|
totalItems |
integer |
จํานวนเล่มทั้งหมดที่พบ ซึ่งอาจมากกว่าจำนวนวอลุ่มที่แสดงผลในคำตอบนี้หากมีการใส่เลขหน้าให้ผลการค้นหา |
|
ลองเลย
ใช้เครื่องมือสํารวจด้านล่างเพื่อเรียกใช้เมธอดนี้กับข้อมูลจริงและดูคําตอบ
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2024-11-08 UTC
[null,null,["อัปเดตล่าสุด 2024-11-08 UTC"],[[["\u003cp\u003eSearches for books based on a provided query string.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by criteria such as availability, format, language, and publication type.\u003c/p\u003e\n"],["\u003cp\u003eOffers control over the number of results, sorting order, and specific data fields returned.\u003c/p\u003e\n"],["\u003cp\u003eCan be used to retrieve information about books, including volume details and access options.\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination to handle large result sets.\u003c/p\u003e\n"]]],[],null,["# Volume: list\n\nPerforms a book search.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP Request\n\n GET https://www.googleapis.com/books/v1/volumes?q={search terms}\n\n### Parameters\n\n| Parameter Name | Value | Description |\n|-------------------|--------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Required Parameters** |||\n| `q` | `string` | Full-text search query string. |\n| **Optional Parameters** |||\n| `download` | `string` | Restrict to volumes by download availability. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`epub`\" - All volumes with epub. |\n| `filter` | `string` | Filter search results. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`ebooks`\" - All Google eBooks. - \"`free-ebooks`\" - Google eBook with full volume text viewability. - \"`full`\" - Public can view entire volume text. - \"`paid-ebooks`\" - Google eBook with a price. - \"`partial`\" - Public able to see parts of text. |\n| `langRestrict` | `string` | Restrict results to books with this language code. |\n| `libraryRestrict` | `string` | Restrict search to this user's library. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`my-library`\" - Restrict to the user's library, any shelf. - \"`no-restrict`\" - Do not restrict based on user's library. |\n| `maxResults` | `unsigned integer` | Maximum number of results to return. Acceptable values are `0` to `40`, inclusive. |\n| `orderBy` | `string` | Sort search results. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`newest`\" - Most recently published. - \"`relevance`\" - Relevance to search terms. |\n| `partner` | `string` | Restrict and brand results for partner ID. |\n| `printType` | `string` | Restrict to books or magazines. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`all`\" - All volume content types. - \"`books`\" - Just books. - \"`magazines`\" - Just magazines. |\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| `showPreorders` | `boolean` | Set to true to show books available for preorder. Defaults to false. |\n| `source` | `string` | String to identify the originator of this request. |\n| `startIndex` | `unsigned integer` | Index of the first result 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 {\n \"kind\": \"books#volumes\",\n \"items\": [\n volume Resource\n ],\n \"totalItems\": (value)\n }\n\n| Property Name | Value | Description | Notes |\n|---------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `kind` | `string` | Resource type. | |\n| `items[]` | `list` | A list of volumes. | |\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\nTry It!\n-------\n\n\nUse the explorer below to call this method on live data and see the response."]]
