Band: Liste
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Führt eine Buchsuche durch.
Jetzt testen
Anfrage
HTTP-Request
GET https://www.googleapis.com/books/v1/volumes?q={search terms}
Parameter
| Parametername |
Wert |
Beschreibung |
| Erforderliche Parameter |
q |
string |
Abfragestring für die Volltextsuche.
|
| Optionale Parameter |
download |
string |
Auf Volumes nach Downloadverfügbarkeit beschränken.
Zulässige Werte sind:
- "
epub" – alle Bände mit EPUB-Dateien.
|
filter |
string |
Suchergebnisse filtern
Zulässige Werte sind:
- „
ebooks“ – alle Google-E-Books
- "
free-ebooks" – Google E-Book mit vollständiger Sichtbarkeit von Text.
- „
full“: Der gesamte Text des Bandes ist öffentlich zugänglich.
- „
paid-ebooks“ – Google-E-Book mit einem Preis.
- „
partial“: Öffentlich sichtbar, Teile des Textes sind sichtbar.
|
langRestrict |
string |
Ergebnisse auf Bücher mit diesem Sprachcode beschränken
|
libraryRestrict |
string |
Suche auf die Mediathek dieses Nutzers beschränken.
Zulässige Werte sind:
- „
my-library“ – auf die Mediathek des Nutzers, beliebiges Fach beschränken
- „
no-restrict“ – Inhalte dürfen nicht basierend auf der Mediathek des Nutzers eingeschränkt werden.
|
maxResults |
unsigned integer |
Maximale Anzahl der zurückzugebenden Ergebnisse.
Zulässige Werte: 0 bis 40.
|
orderBy |
string |
Suchergebnisse sortieren
Zulässige Werte sind:
- „
newest“ – zuletzt veröffentlicht
- „
relevance“ – Relevanz zu Suchbegriffen.
|
partner |
string |
Ergebnisse auf Partner-ID beschränken und mit Branding versehen
|
printType |
string |
Beschränken Sie sich auf Bücher oder Zeitschriften.
Zulässige Werte sind:
- „
all“ – alle Volume-Inhaltstypen.
- „
books“ – Nur Bücher.
- "
magazines": nur Zeitschriften.
|
projection |
string |
Schränken Sie die zurückgegebenen Informationen auf einen Satz ausgewählter Felder ein.
Zulässige Werte sind:
- „
full“: Enthält alle Volume-Daten.
- „
lite“: Enthält einen Teil der Felder in „VolumeInfo“ und „accessInfo“.
|
showPreorders |
boolean |
Legen Sie „true“ fest, um Bücher anzuzeigen, die vorbestellt werden können. Die Standardeinstellung ist "false".
|
source |
string |
String zur Identifizierung des Urhebers dieser Anfrage.
|
startIndex |
unsigned integer |
Index des ersten Ergebnisses, das zurückgegeben werden soll (beginnt bei 0)
|
Anfragetext
Mit dieser Methode keinen Anfragetext bereitstellen.
Antwort
Bei Erfolg gibt diese Methode einen Antworttext mit der folgenden Struktur zurück:
{
"kind": "books#volumes",
"items": [
volume Resource
],
"totalItems": (value)
}
| Property-Name |
Wert |
Beschreibung |
Hinweise |
kind |
string |
Ressourcentyp. |
|
items[] |
list |
Eine Liste von Bänden. |
|
totalItems |
integer |
Gesamtzahl der gefundenen Volumes. Dieser Wert kann größer als die Anzahl der Volumes sein, die in dieser Antwort zurückgegeben werden, wenn die Ergebnisse paginiert wurden. |
|
Testen!
Rufen Sie diese Methode mit dem Explorer unten für Live-Daten auf und sehen Sie sich die Antwort an.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2024-11-08 (UTC).
[null,null,["Zuletzt aktualisiert: 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."]]
