Band: Liste

Führt eine Buchsuche durch. Jetzt testen

Anfragen

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“: Öffentlich kann der gesamte Bandtext sehen.
  • "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 Bibliothek dieses Nutzers beschränken.

Zulässige Werte sind:
  • „my-library“: auf die Mediathek des Nutzers und jedes Regal beschränken.
  • „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

Zulässige Werte sind:
  • "newest": Zuletzt veröffentlicht.
  • "relevance" – Relevanz für Suchbegriffe.
partner string Ergebnisse für Partner-ID einschränken und mit ihnen versehen.
printType string Auf Bücher oder Zeitschriften beschränken

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 Geben Sie "true" an, damit die vorbestellten Bücher angezeigt werden. Die Standardeinstellung ist "false".
source string String zur Identifizierung des Urhebers dieser Anfrage.
startIndex unsigned integer Index des ersten zurückzugebenden Ergebnisses (beginnt mit 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 von Volumes.
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!

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