Band: Liste

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.