Volume

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 Bänden 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. Die unten aufgeführten Volumenfelder sind in der LITE-Projektion verfügbar.

{
  "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 für die Lautstärke. (In LITE-Projektion.)
volumeInfo.authors[] list Die Namen der Autoren und/oder Herausgeber dieses Bandes. (In LITE-Projektion)
volumeInfo.publisher string 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 die Tags „b“, „i“ und „br“. (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-ID.
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“ oder „Thriller“.
volumeInfo.averageRating double Die durchschnittliche Bewertung für dieses Buch. (min = 1.0, max = 5.0)
volumeInfo.ratingsCount integer Die Anzahl der Rezensionsbewertungen für dieses Volume.
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 etwa 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 extra große Größe (Breite von etwa 1.280 Pixeln). (in LITE-Projektion)
volumeInfo.language string Die beste Sprache für dieses Buch (basierend auf den Inhalten). Das ist der zweistellige ISO 639-1-Code, z. B. „fr“ oder „en“.
volumeInfo.mainCategory string Die Hauptkategorie, zu der dieses Buch 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 Die Rezension dieses Nutzers zu diesem Band, falls vorhanden.
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, der die Anfrage stellt, gekauft wurde. (In LITE-Projektion.)
saleInfo object Alle Informationen zu einem Titel im Zusammenhang mit dem eBook-Shop und/oder der Verfügbarkeit zum Kauf. Diese Informationen können vom Land abhängen, aus dem die Anfrage stammt. Bücher sind beispielsweise möglicherweise in bestimmten Ländern 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 oder 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 dreistelliger Währungscode gemäß ISO 4217. (In LITE-Projektion.)
saleInfo.retailPrice object Der tatsächliche Verkaufspreis des Buches. 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 den Erhalt des Texts beziehen. Diese Informationen können je nach Land variieren. Bücher können beispielsweise in einem Land gemeinfrei sein, in einem anderen aber 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 Hier werden der Zugriff und die Sichtbarkeit dieses Volumens in einem einzigen Statusfeld für diesen Nutzer kombiniert. 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. (UTC-Datums-/Uhrzeitformat RFC 3339).
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 angeboten wird.
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 ein EPUB-Buch mit Fließtext entweder als gemeinfreies Werk oder zum Kauf verfügbar. (In LITE-Projektion.)
accessInfo.pdf.isAvailable boolean Ist eine gescannte Bild-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 Einschränkungen für den Downloadzugriff 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, die Anzahl der bereits erworbenen Lizenzen für den Download von Inhalten (einschließlich des anfragenden Clients, sofern lizenziert).
accessInfo.downloadAccess.nonce string Client-Nonce zur Bestätigung. Nur Downloadzugriff und Clientüberprüfung.
accessInfo.downloadAccess.source string Client-App-ID für die Bestätigung. 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.