Volume: daftar
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Melakukan penelusuran buku.
Coba sekarang.
Permintaan
Permintaan HTTP
GET https://www.googleapis.com/books/v1/volumes?q={search terms}
Parameter
Nama Parameter |
Nilai |
Deskripsi |
Parameter Wajib |
q |
string |
String kueri penelusuran teks lengkap.
|
Parameter Opsional |
download |
string |
Membatasi ke volume berdasarkan ketersediaan download.
Nilai yang dapat diterima adalah:
- "
epub " - Semua volume dengan epub.
|
filter |
string |
Memfilter hasil penelusuran.
Nilai yang dapat diterima adalah:
- "
ebooks " - Semua Google eBuku.
- "
free-ebooks " - Google eBook dengan visibilitas teks volume penuh.
- "
full " - Publik dapat melihat seluruh teks volume.
- "
paid-ebooks " - eBook Google dengan harga.
- "
partial " - Publik dapat melihat bagian teks.
|
langRestrict |
string |
Membatasi hasil pada buku dengan kode bahasa ini.
|
libraryRestrict |
string |
Batasi penelusuran ke koleksi pengguna ini.
Nilai yang dapat diterima:
- "
my-library " - Batasi ke koleksi pengguna, rak mana pun.
- "
no-restrict " - Jangan batasi berdasarkan library pengguna.
|
maxResults |
unsigned integer |
Jumlah hasil maksimum yang akan ditampilkan.
Nilai yang dapat diterima adalah 0 hingga 40 , inklusif.
|
orderBy |
string |
Mengurutkan hasil penelusuran.
Nilai yang dapat diterima adalah:
- "
newest " - Baru saja dipublikasikan.
- "
relevance " - Relevansi dengan istilah penelusuran.
|
partner |
string |
Membatasi dan memberi merek pada hasil untuk ID partner.
|
printType |
string |
Batasi ke buku atau majalah.
Nilai yang dapat diterima adalah:
- "
all " - Semua jenis konten volume.
- "
books " - Hanya buku.
- "
magazines " - Hanya majalah.
|
projection |
string |
Membatasi informasi yang ditampilkan pada sekumpulan kolom yang dipilih.
Nilai yang dapat diterima adalah:
- "
full " - Menyertakan semua data volume.
- "
lite " - Menyertakan subkumpulan kolom di volumeInfo dan accessInfo.
|
showPreorders |
boolean |
Tetapkan ke benar (true) untuk menampilkan buku yang tersedia untuk praorder. Nilai defaultnya adalah false (salah).
|
source |
string |
String untuk mengidentifikasi asal permintaan ini.
|
startIndex |
unsigned integer |
Indeks hasil pertama yang akan ditampilkan (dimulai dari 0)
|
Isi Permintaan
Jangan berikan isi permintaan dengan metode ini.
Respons
Jika berhasil, metode ini akan menampilkan isi respons dengan struktur berikut:
{
"kind": "books#volumes",
"items": [
volume Resource
],
"totalItems": (value)
}
Nama Properti |
Nilai |
Deskripsi |
Catatan |
kind |
string |
Jenis resource. |
|
items[] |
list |
Daftar volume. |
|
totalItems |
integer |
Jumlah total volume yang ditemukan. Jumlah ini mungkin lebih besar dari jumlah volume yang ditampilkan dalam respons ini jika hasil telah diberi nomor halaman. |
|
Cobalah!
Gunakan penjelajah di bawah untuk memanggil metode ini pada data langsung dan melihat responsnya.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2024-11-08 UTC.
[null,null,["Terakhir diperbarui pada 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."]]