Volumen: Liste

Führt eine Buchsuche durch. Jetzt testen.

Anfragen

HTTP-Anfrage

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 Downloads nach Verfügbarkeit beschränken.

Folgende Werte sind zulässig:
  • „epub“ – Alle Bände mit EPUB.
filter string Suchergebnisse filtern

Folgende Werte sind zulässig:
  • „ebooks“ – Alle Google eBooks.
  • „free-ebooks“ – Google E-Book mit vollständiger Textsichtbarkeit.
  • „full“: Der öffentliche Text ist für alle Nutzer sichtbar.
  • „paid-ebooks“ – Google E-Book mit einem Preis.
  • "partial": Öffentlicher Teil des Textes
langRestrict string Ergebnisse auf Bücher mit diesem Sprachcode beschränken.
libraryRestrict string Suche auf die Mediathek dieses Nutzers beschränken.

Folgende Werte sind zulässig:
  • „my-library“: auf die Bibliothek des Nutzers beschränken, beliebige Ablage
  • „no-restrict“: Keine Einschränkung basierend auf der Mediathek des Nutzers.
maxResults unsigned integer Maximale Anzahl der zurückzugebenden Ergebnisse; Zulässige Werte: 0 bis 40.
orderBy string Suchergebnisse sortieren.

Folgende Werte sind zulässig:
  • "newest" – zuletzt veröffentlicht.
  • „relevance“: Relevanz für Suchbegriffe.
partner string Ergebnisse für Partner-ID einschränken und kennzeichnen.
printType string Auf Bücher oder Zeitschriften beschränken.

Folgende Werte sind zulässig:
  • „all“ – Alle Inhaltstypen vom Typ „Volume“.
  • "books" – Nur Bücher.
  • "magazines" – nur Zeitschriften
projection string Einschränkung der auf bestimmte Felder zurückgegebenen Informationen beschränken.

Folgende Werte sind zulässig:
  • „full“: Enthält alle Volume-Daten.
  • „lite“: Enthält eine Teilmenge der Felder in „volumeInfo“ und „accessInfo“.
showPreorders boolean Auf „true“ setzen, um vorbestellbare Bücher anzuzeigen. Die Standardeinstellung ist "false".
source string String zur Identifizierung des Ursprungs dieser Anfrage.
startIndex unsigned integer Index des ersten zurückzugebenden Ergebnisses (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)
}
Eigenschaftsname Wert Beschreibung Hinweise
kind string Ressourcentyp.
items[] list Eine Liste der Bände.
totalItems integer Gesamtzahl der gefundenen Bände. Dieser Wert ist möglicherweise größer als die Anzahl der in dieser Antwort zurückgegebenen Volumes, wenn die Ergebnisse paginiert sind.

Jetzt testen

Verwenden Sie den Explorer unten, um diese Methode für Live-Daten aufzurufen und sich die Antwort anzusehen.