Birim: liste
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Kitap araması yapar.
Şimdi deneyin.
İstek
HTTP İsteği
GET https://www.googleapis.com/books/v1/volumes?q={search terms}
Parametreler
Parametre Adı |
Değer |
Açıklama |
Gerekli Parametreler |
q |
string |
Tam metin arama sorgu dizesi.
|
İsteğe bağlı parametreler |
download |
string |
İndirilebilirlik durumuna göre ciltleri kısıtlayın.
Kabul edilen değerler şunlardır:
- "
epub " - EPUB içeren tüm ciltler.
|
filter |
string |
Arama sonuçlarını filtreleyin.
Kabul edilen değerler şunlardır:
- "
ebooks ": Tüm Google e-kitapları.
- "
free-ebooks ": Tam sesle metin görüntülenebilirliğine sahip Google e-kitabı.
- "
full ": Herkese açık kullanıcılar cilt metninin tamamını görüntüleyebilir.
- "
paid-ebooks " - Fiyatı olan Google e-Kitap.
- "
partial ": Herkese açık kullanıcılar metnin bazı bölümlerini görebilir.
|
langRestrict |
string |
Sonuçları, bu dil koduna sahip kitaplarla sınırlayın.
|
libraryRestrict |
string |
Aramayı bu kullanıcının kitaplığıyla sınırlandır.
Kabul edilen değerler şunlardır:
- "
my-library ": Kullanıcının kitaplığıyla veya herhangi bir rafıyla sınırlı.
- "
no-restrict ": Kullanıcının kitaplığına göre kısıtlama yapmayın.
|
maxResults |
unsigned integer |
Döndürülecek maksimum sonuç sayısı.
Kabul edilen değerler 0 ile 40 arasıdır (bu değerler dahil).
|
orderBy |
string |
Arama sonuçlarını sıralama
Kabul edilen değerler şunlardır:
- "
newest " - En son yayınlananlar.
- "
relevance ": Arama terimleriyle alaka düzeyi.
|
partner |
string |
İş ortağı kimliği için sonuçları kısıtlama ve marka sonuçları
|
printType |
string |
Kitap veya dergilerle sınırlandırın.
Kabul edilen değerler şunlardır:
- "
all " - Tüm ses seviyesi içerik türleri.
- "
books ": Yalnızca kitaplar.
- "
magazines ": Yalnızca dergiler.
|
projection |
string |
Seçilen alan grubuna döndürülen bilgileri kısıtlayın.
Kabul edilen değerler şunlardır:
- "
full ": Tüm birim verilerini içerir.
- "
lite ": volumeInfo ve accessInfo'daki alanların bir alt kümesini içerir.
|
showPreorders |
boolean |
Ön sipariş verilebilecek kitapları göstermek için doğru değerine ayarlayın. Varsayılan değer yanlıştır.
|
source |
string |
Bu isteği gönderen kişiyi tanımlayan dize.
|
startIndex |
unsigned integer |
Döndürülecek ilk sonucun dizini (0'dan başlar)
|
İstek Metni
Bu yöntemle istek gövdesi sağlamayın.
Yanıt
Başarılı olursa bu yöntem aşağıdaki yapıya sahip bir yanıt metni döndürür:
{
"kind": "books#volumes",
"items": [
volume Resource
],
"totalItems": (value)
}
Mülk Adı |
Değer |
Açıklama |
Notlar |
kind |
string |
Kaynak türü. |
|
items[] |
list |
Hacim listesi. |
|
totalItems |
integer |
Bulunan toplam cilt sayısı. Sonuçlar sayfalara ayrılmışsa bu sayı, bu yanıtta döndürülen cilt sayısından fazla olabilir. |
|
Deneyin!
Canlı verilerde bu yöntemi çağırmak ve yanıtı görmek için aşağıdaki keşif aracını kullanın.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2024-11-08 UTC.
[null,null,["Son güncelleme tarihi: 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."]]