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.listbooks.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) | |
selfLink |
string |
URL zu dieser 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 |
object |
Eine Liste der Bildlinks für alle verfügbaren Größen. (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. | |
volumeInfo.previewLink |
string |
URL zur Vorschau dieses Bandes auf der Google Books-Website. | |
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.) | |
saleInfo.buyLink |
string |
URL zum Kauf dieses Bandes auf der Google Books-Website (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.epub.downloadLink |
string |
URL zum Herunterladen der EPUB-Datei. (In LITE-Projektion.) | |
accessInfo.epub.acsTokenLink |
string |
URL zum Abrufen des ACS-Tokens für den EPUB-Download. (In LITE-Projektion.) | |
accessInfo.pdf |
object |
Informationen zu PDF-Inhalten. (in LITE-Projektion) | |
accessInfo.pdf.downloadLink |
string |
URL zum Herunterladen der PDF-Datei. (In LITE-Projektion.) | |
accessInfo.pdf.acsTokenLink |
string |
URL zum Abrufen des ACS-Tokens für den PDF-Download. (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. | |
|
string |
URL zum Anzeigen von Informationen zu diesem Band auf der Google Books-Website. (In LITE-Projektion) | |
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). | |
volumeInfo.canonicalVolumeLink |
string |
Kanonische URL für ein Volume. (In LITE-Projektion.) | |
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.webReaderLink |
string |
URL zum Lesen dieses Bandes auf der Google Books-Website Über den Link können Nutzer nicht sichtbare Volumes lesen. | |
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. |