Volumen

Eine Volume-Sammlung wird verwendet, um eine Suche durchzuführen oder den Inhalt eines Bücherregals aufzulisten. 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 Volumes und erfordert eine Authentifizierung.
books.mylibrary.bookshelves.volumes.list

get
Ruft eine Volume-Ressource basierend auf der ID ab.
list
Führt eine Buchsuche durch.

Ressourcendarstellungen

Ein Volume stellt die Informationen zu einem Buch oder einer Zeitschrift dar, die bei Google Books gehostet werden. Es enthält Metadaten wie Titel und Autor sowie personalisierte Daten, wie z. B., ob das Produkt gekauft wurde oder nicht. 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
  }
}
Eigenschaftsname 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 Titel des Bandes. (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 Verlag dieses Bandes. (In LITE-Projektion.)
volumeInfo.publishedDate string Veröffentlichungsdatum. (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 Kennzeichnungen nach Branchenstandard 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 Volumens.
volumeInfo.dimensions.height string Höhe oder Länge dieses Bandes (in cm).
volumeInfo.dimensions.width string Die Breite dieses Volumens (in cm).
volumeInfo.dimensions.thickness string Dicke dieses Volumens (in cm).
volumeInfo.printType string Art der Veröffentlichung dieses Bandes. Mögliche Werte sind BOOK oder MAGAZINE.
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 Bandinhalts (Text und Bilder). (In LITE-Projektion)
volumeInfo.imageLinks.thumbnail string Bildlink für die Größe der Miniaturansicht (Breite: ca. 128 Pixel). (in LITE-Projektion)
volumeInfo.imageLinks.small string Bildlink für kleine Größen (Breite von ca. 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 ca. 800 Pixeln) (in LITE-Projektion)
volumeInfo.imageLinks.smallThumbnail string Bildlink für kleine Miniaturansichten (Breite von ca. 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 Je nach Inhalt ist die beste Sprache für diesen Band. 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. Dabei ist die Kategorie aus der unten zurückgegebenen Kategorienliste mit der höchsten Gewichtung.
userInfo object Nutzerspezifische Informationen zu diesem Volume. (z.B. die Seite, die der Nutzer zuletzt gelesen hat, oder ob er das 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 in dem Band, falls verfügbar. (In LITE-Projektion.)
userInfo.isPurchased boolean Gibt an, ob dieses Volume von dem 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. Das bedeutet, dass Bücher in bestimmten Ländern möglicherweise nicht zum Verkauf angeboten werden.
saleInfo.country string Der aus zwei Buchstaben bestehende ISO_3166-1-Ländercode, für den diese Verkaufsinformationen gültig sind. (In LITE-Projektion.)
saleInfo.saleability string Gibt an, ob dieses Buch für das oben genannte Land zum Verkauf angeboten oder kostenlos im Google E-Book-Store angeboten wird. Mögliche Werte sind FOR_SALE, FREE, NOT_FOR_SALE und FOR_PREORDER.
saleInfo.isEbook boolean Gibt an, ob es sich bei diesem Band um ein E-Book handelt (kann zum 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 Buchs. Sofern es keine Angebote oder Rabatte für dieses Band gibt, ist dies dasselbe wie die unverbindliche Preisempfehlung. (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 aus zwei Buchstaben bestehende ISO_3166-1-Ländercode, für den diese Zugangsinformationen 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 einen Teil des Bandes zur öffentlichen Ansicht ohne Kauf zugelassen hat. Dies gilt sowohl für E-Books als auch für andere Bücher. Gemeinfreie Bücher 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 Legt fest, ob dieses Volume mithilfe der Embedded Viewer API in einen Darstellungsbereich eingebettet werden kann.
accessInfo.publicDomain boolean Gibt an, ob dieses Buch im oben genannten Land urheberrechtsfrei ist.
userInfo.updated datetime Zeitstempel, der angibt, wann dieser Band zuletzt durch eine Nutzeraktion geändert wurde, z. B. ein Update einer Position zum Lesen, ein Buch kaufen oder eine Rezension schreiben. (Datum/Uhrzeit-Format: RFC 3339 UTC).
userInfo.isPreordered boolean Gibt an, ob dieser Band vom authentifizierten Nutzer, der die Anfrage gestellt hat, 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 diese Lautstärke zulässig ist. Mögliche 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 eine gescannte PDF-Datei mit Bildern, die entweder als urheberrechtsfreie Inhalte („Public Domain“) oder zum Kauf erhältlich ist. (In LITE-Projektion.)
accessInfo.downloadAccess nested object Informationen zu den Zugriffsbeschränkungen für die Downloadlizenz eines Volumes.
accessInfo.downloadAccess.kind string Ressourcentyp.
accessInfo.downloadAccess.volumeId string Gibt das Volume an, für das dieser Eintrag gilt.
accessInfo.downloadAccess.restricted boolean Gibt an, ob für dieses Volume Downloadzugriffsbeschränkungen gelten.
accessInfo.downloadAccess.deviceAllowed boolean Gibt an, ob der Zugriff dafür gewährt wird (Nutzer, Gerät, Volume).
accessInfo.downloadAccess.justAcquired boolean Wenn „deviceAllowed“ angezeigt wird, ob gerade Zugriff mit dieser Anfrage erhalten wurde.
accessInfo.downloadAccess.maxDownloadDevices integer Wenn der Zugriff eingeschränkt ist, die maximale Anzahl von Lizenzen zum Herunterladen 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 Clientvalidierung.
accessInfo.downloadAccess.source string ID der Client-App zur Überprüfung. Nur Downloadzugriff und Clientvalidierung.
accessInfo.downloadAccess.reasonCode string Ursachencode für Fehler/Warnung. In Zukunft werden möglicherweise weitere Codes 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 Suchergebnisinformationen zu diesem Band.
searchInfo.textSnippet string Ein Text-Snippet, das die Suchanfrage enthält.