Lautstärke

Mit einer Volume-Sammlung können Sie eine Suche durchführen oder den Inhalt eines Bücherregals auflisten. Diese Sammlung ist schreibgeschützt.

Methoden

Die folgenden Methoden gelten für die öffentlichen Daten zu Volumes und erfordern keine Authentifizierung.
books.volumes.list
books.volumes.get

Die folgende Methode gilt für die private Ansicht „Meine Bibliothek“ von Bänden und erfordert eine Authentifizierung.
books.mylibrary.bookshelves.volumes.list

get
Ruft eine Volumeressource anhand der ID ab.
list
Führt eine Buchsuche durch.

Ressourcendarstellungen

Ein Band stellt Informationen dar, die Google Books zu einem Buch oder einer Zeitschrift hostet. Sie enthält Metadaten wie Titel und Autor sowie personalisierte Daten, z. B. ob der Titel gekauft wurde. In der LITE-Projektion verfügbare Volume-Felder sind unten aufgeführt.

{
  "kind": "books#volume",
  "id": string,
  "etag": string,
  "selfLink": string,
  "volumeInfo": {
    "title": string,
    "subtitle": string,
    "authors": [
      string
    ],
    "publisher": string,
    "publishedDate": string,
    "description": string,
    "industryIdentifiers": [
      {
        "type": string,
        "identifier": string
      }
    ],
    "pageCount": integer,
    "dimensions": {
      "height": string,
      "width": string,
      "thickness": string
    },
    "printType": string,
    "mainCategory": string,
    "categories": [
      string
    ],
    "averageRating": double,
    "ratingsCount": integer,
    "contentVersion": string,
    "imageLinks": {
      "smallThumbnail": string,
      "thumbnail": string,
      "small": string,
      "medium": string,
      "large": string,
      "extraLarge": string
    },
    "language": string,
    "previewLink": string,
    "infoLink": string,
    "canonicalVolumeLink": string
  },
  "userInfo": {
    "review": mylibrary.reviews Resource,
    "readingPosition": mylibrary.readingpositions Resource,
    "isPurchased": boolean,
    "isPreordered": boolean,
    "updated": datetime
  },
  "saleInfo": {
    "country": string,
    "saleability": string,
    "onSaleDate": datetime,
    "isEbook": boolean,
    "listPrice": {
      "amount": double,
      "currencyCode": string
    },
    "retailPrice": {
      "amount": double,
      "currencyCode": string
    },
    "buyLink": string
  },
  "accessInfo": {
    "country": string,
    "viewability": string,
    "embeddable": boolean,
    "publicDomain": boolean,
    "textToSpeechPermission": string,
    "epub": {
      "isAvailable": boolean,
      "downloadLink": string,
      "acsTokenLink": string
    },
    "pdf": {
      "isAvailable": boolean,
      "downloadLink": string,
      "acsTokenLink": string
    },
    "webReaderLink": string,
    "accessViewStatus": string,
    "downloadAccess": {
      "kind": "books#downloadAccessRestriction",
      "volumeId": string,
      "restricted": boolean,
      "deviceAllowed": boolean,
      "justAcquired": boolean,
      "maxDownloadDevices": integer,
      "downloadsAcquired": integer,
      "nonce": string,
      "source": string,
      "reasonCode": string,
      "message": string,
      "signature": string
    }
  },
  "searchInfo": {
    "textSnippet": string
  }
}
Property-Name Wert Beschreibung Hinweise
kind string Ressourcentyp für ein Volume. (In LITE-Projektion.)
id string Eindeutige Kennung für ein Volume. (In LITE-Projektion.)
etag string Intransparente Kennung für eine bestimmte Version einer Volume-Ressource. (In LITE-Projektion)
volumeInfo object Allgemeine Informationen zum Volume.
volumeInfo.title string Bandtitel. (In LITE-Projektion.)
volumeInfo.subtitle string Untertitel des Bandes. (In LITE-Projektion.)
volumeInfo.authors[] list Die Namen der Autoren und/oder Herausgeber dieses Bandes. (In LITE-Projektion)
volumeInfo.publisher string Der Verlag dieses Bandes. (In LITE-Projektion.)
volumeInfo.publishedDate string Datum der Veröffentlichung. (In LITE-Projektion.)
volumeInfo.description string Eine Zusammenfassung des Bandes. Der Text der Beschreibung ist in HTML formatiert und enthält einfache Formatierungselemente wie b-, i- und br-Tags. (in LITE-Projektion)
volumeInfo.industryIdentifiers[] list Branchenstandard-IDs für dieses Volumen.
volumeInfo.industryIdentifiers[].type string ID-Typ. Mögliche Werte sind ISBN_10, ISBN_13, ISSN und OTHER.
volumeInfo.industryIdentifiers[].identifier string Branchenspezifische Volume-Kennung.
volumeInfo.pageCount integer Gesamtzahl der Seiten
volumeInfo.dimensions object Die physischen Abmessungen dieses Volumes.
volumeInfo.dimensions.height string Höhe oder Länge dieses Buchs (in cm).
volumeInfo.dimensions.width string Breite dieses Volumes (in cm).
volumeInfo.dimensions.thickness string Dicke dieses Volumens (in cm).
volumeInfo.printType string Art der Veröffentlichung dieses Bandes. Mögliche Werte sind „BUCH“ oder „MAGAZIN“.
volumeInfo.categories[] list Eine Liste von Themenkategorien wie "Belletristik", "Spannung" usw.
volumeInfo.averageRating double Die durchschnittliche Rezensionsbewertung für diesen Band. (Min.= 1,0, Max.= 5,0)
volumeInfo.ratingsCount integer Die Anzahl der Rezensionsbewertungen für diesen Band.
volumeInfo.contentVersion string Eine Kennung für die Version des Inhalts des Buchs (Text und Bilder). (In LITE-Projektion)
volumeInfo.imageLinks.thumbnail string Bildlink für Thumbnail-Größe (Breite von etwa 128 Pixeln). (in LITE-Projektion)
volumeInfo.imageLinks.small string Bildlink für kleine Größe (Breite von etwa 300 Pixeln). (in LITE-Projektion)
volumeInfo.imageLinks.medium string Bildlink für mittlere Größe (Breite von ca. 575 Pixeln). (in LITE-Projektion)
volumeInfo.imageLinks.large string Bildlink für große Größe (Breite von etwa 800 Pixeln). (in LITE-Projektion)
volumeInfo.imageLinks.smallThumbnail string Bildlink für kleine Thumbnail-Größe (Breite von etwa 80 Pixeln). (in LITE-Projektion)
volumeInfo.imageLinks.extraLarge string Bildlink für extragroße Größen (Breite von ca. 1.280 Pixeln). (in LITE-Projektion)
volumeInfo.language string Die beste Sprache für dieses Buch (basierend auf den Inhalten). Es handelt sich um den aus zwei Buchstaben bestehenden ISO 639-1-Code, z. B. „fr“ oder „en“.
volumeInfo.mainCategory string Die Hauptkategorie, zu der dieses Band gehört. Das ist die Kategorie aus der unten zurückgegebenen Liste der Kategorien mit dem höchsten Gewicht.
userInfo object Nutzerspezifische Informationen zu diesem Datenvolumen. (z.B. die Seite, die dieser Nutzer zuletzt gelesen hat, oder ob er dieses Buch gekauft hat)
userInfo.review nested object Sofern vorhanden, eine Nutzerrezension dieses Nutzers zu diesem Band.
userInfo.readingPosition readingPosition Resource Die aktuelle Leseposition des Nutzers im Buch, falls verfügbar. (In LITE-Projektion.)
userInfo.isPurchased boolean Gibt an, ob dieses Buch vom authentifizierten Nutzer gekauft wurde, der die Anfrage stellt. (In LITE-Projektion.)
saleInfo object Alle Informationen zu einem Band, das sich auf den E-Book-Store und/oder die Kaufbarkeit bezieht. Diese Informationen können vom Land abhängen, aus dem die Anfrage stammt. Bücher sind beispielsweise in bestimmten Ländern möglicherweise nicht zum Verkauf verfügbar.
saleInfo.country string Der zweistellige ISO_3166-1-Ländercode, für den diese Angebotsinformationen gelten. (In LITE-Projektion.)
saleInfo.saleability string Gibt an, ob dieses Buch im Google eBookstore für das oben aufgeführte Land zum Verkauf angeboten oder kostenlos erhältlich ist. Mögliche Werte sind FOR_SALE, FREE, NOT_FOR_SALE und FOR_PREORDER.
saleInfo.isEbook boolean Ob es sich bei diesem Band um ein E-Book handelt (kann dem Regal „Meine E-Books“ hinzugefügt werden).
saleInfo.listPrice object Unverbindliche Preisempfehlung. (in LITE-Projektion)
saleInfo.listPrice.amount double Betrag in der unten aufgeführten Währung. (In LITE-Projektion.)
saleInfo.listPrice.currencyCode string Ein aus drei Buchstaben bestehender ISO 4217-Währungscode. (In LITE-Projektion.)
saleInfo.retailPrice object Der tatsächliche Verkaufspreis des Buchs. Dieser entspricht dem empfohlenen Einzelhandelspreis oder Listenpreis, es sei denn, es gibt Angebote oder Rabatte für diese Menge. (in LITE-Projektion)
saleInfo.retailPrice.amount double Betrag in der unten aufgeführten Währung. (In LITE-Projektion.)
saleInfo.retailPrice.currencyCode string Ein dreistelliger Währungscode gemäß ISO 4217. (In LITE-Projektion.)
accessInfo object Alle Informationen zu einem Band, die sich auf das Lesen oder Abrufen dieses Bandtexts beziehen. Diese Informationen können je nach Land unterschiedlich sein. Bücher sind möglicherweise in einem Land urheberrechtsfrei („Public Domain“), in einem anderen jedoch nicht.
accessInfo.country string Der zweistellige ISO_3166-1-Ländercode, für den diese Zugriffsinformationen gültig sind. (In LITE-Projektion.)
accessInfo.viewability string Der Lesezugriff auf ein Volume. Mögliche Werte sind PARTIAL, ALL_PAGES, NO_PAGES oder UNKNOWN. Dieser Wert hängt vom oben aufgeführten Land ab. Der Wert „PARTIAL“ bedeutet, dass der Publisher erlaubt hat, einen Teil des Volumens ohne Kauf öffentlich anzusehen. Dies kann sowohl für E-Books als auch für andere Bücher gelten. Bücher aus dem öffentlichen Domain haben immer den Wert „ALL_PAGES“.
accessInfo.epub object Informationen zu EPUB-Inhalten. (in LITE-Projektion)
accessInfo.pdf object Informationen zu PDF-Inhalten. (in LITE-Projektion)
accessInfo.accessViewStatus string Kombiniert den Zugriff und die Sichtbarkeit dieses Bandes in einem Statusfeld für diesen Nutzer. Mögliche Werte sind FULL_PURCHASED, FULL_PUBLIC_DOMAIN, SAMPLE oder NONE. (In LITE-Projektion.)
accessInfo.embeddable boolean Gibt an, ob dieses Volume mit der Embedded Viewer API in einen Darstellungsbereich eingebettet werden kann.
accessInfo.publicDomain boolean Gibt an, ob dieses Buch im oben aufgeführten Land urheberrechtsfrei ist.
userInfo.updated datetime Zeitstempel, zu dem dieses Buch zuletzt durch eine Nutzeraktion geändert wurde, z. B. durch Aktualisierung der Leseposition, Kauf des Buchs oder Verfassen einer Rezension. (Datum-Uhrzeitformat im RFC 3339-UTC-Format).
userInfo.isPreordered boolean Gibt an, ob dieses Buch vom authentifizierten Nutzer, der die Anfrage stellt, vorbestellt wurde. (In LITE-Projektion.)
saleInfo.onSaleDate datetime Das Datum, an dem dieses Buch zum Verkauf verfügbar ist.
accessInfo.textToSpeechPermission string Gibt an, ob die Sprachausgabe für dieses Volume zulässig ist. Zulässige Werte sind ALLOWED, ALLOWED_FOR_ACCESSIBILITY oder NOT_ALLOWED.
accessInfo.epub.isAvailable boolean Ist eine EPUB-Datei mit Fließtext, die entweder frei von Urheberrechten ist oder zum Kauf erhältlich ist. (In LITE-Projektion.)
accessInfo.pdf.isAvailable boolean Ist ein gescanntes Bild als PDF entweder als gemeinfreies Bild oder zum Kauf verfügbar? (In LITE-Projektion.)
accessInfo.downloadAccess nested object Informationen zu den Zugriffsbeschränkungen der Downloadlizenz eines Bandes.
accessInfo.downloadAccess.kind string Ressourcentyp.
accessInfo.downloadAccess.volumeId string Gibt das Volume an, auf das sich dieser Eintrag bezieht.
accessInfo.downloadAccess.restricted boolean Gibt an, ob für dieses Volume Downloadzugriffsbeschränkungen gelten.
accessInfo.downloadAccess.deviceAllowed boolean Wenn eingeschränkt, ob der Zugriff für diesen Nutzer, dieses Gerät oder dieses Volume gewährt wird.
accessInfo.downloadAccess.justAcquired boolean Gibt an, ob der Zugriff mit dieser Anfrage gerade gewährt wurde.
accessInfo.downloadAccess.maxDownloadDevices integer Falls eingeschränkt, die maximale Anzahl von Lizenzen für den Download von Inhalten für dieses Volume.
accessInfo.downloadAccess.downloadsAcquired integer Falls eingeschränkt: Anzahl der bereits erworbenen Lizenzen zum Herunterladen von Inhalten (einschließlich des anfordernden Clients, falls lizenziert).
accessInfo.downloadAccess.nonce string Client-Nonce für die Überprüfung. Nur Downloadzugriff und Clientüberprüfung.
accessInfo.downloadAccess.source string ID der Client-App zur Überprüfung. Nur Downloadzugriff und Clientüberprüfung.
accessInfo.downloadAccess.reasonCode string Der Code für die Ursache des Fehlers oder der Warnung. Weitere Codes werden möglicherweise in Zukunft hinzugefügt. 0 OK 100 ACCESS_DENIED_PUBLISHER_LIMIT 101 ACCESS_DENIED_LIMIT 200 WARNING_USED_LAST_ACCESS
accessInfo.downloadAccess.message string Fehler-/Warnmeldung.
accessInfo.downloadAccess.signature string Antwortsignatur.
searchInfo object Informationen zu den Suchergebnissen, die sich auf dieses Volumen beziehen.
searchInfo.textSnippet string Ein Text-Snippet mit der Suchanfrage.