Mit der Sammlung
Volume
wird eine Suche durchgeführt oder der Inhalt eines Bücherregals aufgeführt. 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 Mediathek“ von Volumes und erfordert eine Authentifizierung.
books.meinemediathek.buchregale.volumes.list- erhalten
- Ruft eine Volume-Ressource basierend auf der ID ab.
- list
- Führt eine Buchsuche aus.
Ressourcendarstellungen
Ein Band repräsentiert Informationen, die Google Bücher zu einem Buch oder einer Zeitschrift hostet. Sie enthalten Metadaten wie Titel und Autor sowie personalisierte Daten, beispielsweise, ob sie gekauft wurden oder nicht. Volume-Felder, die in der LITE-Projektion verfügbar sind, werden unten beschrieben.
{ "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 |
Undurchsichtige 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 Volumen | |
volumeInfo.title |
string |
Titel des Bands. (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 dieser Band. (In LITE-Projektion) | |
volumeInfo.publisher |
string |
Publisher dieses Bandes. (In LITE-Projektion). | |
volumeInfo.publishedDate |
string |
Veröffentlichungsdatum. (In LITE-Projektion). | |
volumeInfo.description |
string |
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-Kennungen 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 Volumenkennung. | |
volumeInfo.pageCount |
integer |
Gesamtzahl der Seiten. | |
volumeInfo.dimensions |
object |
Physische Abmessungen dieses Volumens. | |
volumeInfo.dimensions.height |
string |
Höhe oder Länge dieses Volumens (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 BOOK oder MAGAZINE. | |
volumeInfo.categories[] |
list |
Eine Liste von Themenkategorien, z. B. „Belletristik“ oder „Spannung“ | |
volumeInfo.averageRating |
double |
Die durchschnittliche Bewertung für diesen Band. (min = 1, max. = 5,0) | |
volumeInfo.ratingsCount |
integer |
Die Anzahl der Rezensionen für dieses Band. | |
volumeInfo.contentVersion |
string |
Eine Kennung für die Version des Volume-Inhalts (Text und Bilder). (In LITE-Projektion) | |
volumeInfo.imageLinks |
object |
Eine Liste von Bildlinks für alle verfügbaren Größen. (in LITE-Projektion) | |
volumeInfo.imageLinks.thumbnail |
string |
Bildlink für Miniaturansicht (Breite: ca. 128 Pixel). (in LITE-Projektion) | |
volumeInfo.imageLinks.small |
string |
Bildlink für kleines Bild (Breite: ca. 300 Pixel) (in LITE-Projektion) | |
volumeInfo.imageLinks.medium |
string |
Bildlink für mittlere Größe (Breite ca. 575 Pixel). (in LITE-Projektion) | |
volumeInfo.imageLinks.large |
string |
Bildlink für große Anzeige (Breite: ca. 800 Pixel). (in LITE-Projektion) | |
volumeInfo.imageLinks.smallThumbnail |
string |
Bildlink für die kleine Miniaturansicht (Breite: ca. 80 Pixel). (in LITE-Projektion) | |
volumeInfo.imageLinks.extraLarge |
string |
Bildlink für besonders große Größe (ca. 1.280 Pixel) (in LITE-Projektion) | |
volumeInfo.language |
string |
Beste Sprache für dieses Band (basierend auf dem Inhalt). Es handelt sich dabei um den aus zwei Buchstaben bestehenden ISO 639-1-Code wie „fr“ oder „en“. | |
volumeInfo.mainCategory |
string |
Die Hauptkategorie, zu der dieses Volume gehört. Die Kategorie mit den höchsten Gewichtungen wird aus der Kategorienliste unten zurückgegeben. | |
volumeInfo.previewLink |
string |
URL zur Vorschau dieses Bandes auf der Google Books-Website. | |
userInfo |
object |
Nutzerspezifische Informationen zu diesem Band. (z.B. Seite, die der Nutzer zuletzt gelesen hat oder das Buch gekauft hat) | |
userInfo.review |
nested object |
Die Rezension dieses Nutzers, sofern vorhanden. | |
userInfo.readingPosition |
readingPosition Resource |
Die aktuelle Leseposition des Nutzers im Band, sofern eine verfügbar ist. (In LITE-Projektion). | |
userInfo.isPurchased |
boolean |
Gibt an, ob dieses Volume vom authentifizierten Nutzer, der die Anfrage gesendet hat, gekauft wurde. (In LITE-Projektion). | |
saleInfo |
object |
Jegliche Informationen zum Band in Bezug auf den E-Book-Store und/oder die Kaufbarkeit Diese Informationen können je nach Land unterschiedlich sein, aus dem die Anfrage stammt (z.B. werden Bücher in bestimmten Ländern möglicherweise nicht verkauft). | |
saleInfo.country |
string |
Der aus zwei Buchstaben bestehende ISO_3166-1-Ländercode, für den diese Verkaufsinformationen gelten. (In LITE-Projektion). | |
saleInfo.saleability |
string |
Gibt an, ob dieses Buch zum Verkauf oder zur kostenlosen Nutzung im Google E-Book-Store des oben aufgeführten Landes angeboten wird. Mögliche Werte sind FOR_SALE, FREE, NOT_FOR_SALE oder FOR_PREORDER. | |
saleInfo.isEbook |
boolean |
Gibt an, ob es sich bei diesem Band um ein E-Book handelt (kann zum Regal „Meine eBooks“ 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 nach ISO 4217. (In LITE-Projektion). | |
saleInfo.retailPrice |
object |
Der tatsächliche Verkaufspreis des Buchs. Dieser Wert ist mit dem empfohlenen Einzelhandels- oder Listenpreis identisch, es sei denn, für dieses Band gelten Angebote oder Rabatte. (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 nach 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 über ein Band im Zusammenhang mit dem Lesen oder Abrufen dieses Bandtexts. Diese Informationen können je nach Land unterschiedlich sein. Bücher können in einem Land gemeinfrei sein, in einem anderen jedoch nicht. | |
accessInfo.country |
string |
Der aus zwei Buchstaben bestehende ISO 3166-1-Ländercode, für den diese Zugriffsinformationen gelten. (In LITE-Projektion). | |
accessInfo.viewability |
string |
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. Ein Wert von PARTIAL bedeutet, dass der Verlag oder Webpublisher zugelassen hat, dass ein Teil des Bandes ohne Kauf zugänglich ist. Dies kann sowohl für E-Books als auch für E-Books gelten. 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 des PDF. (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 Volumes in einem einzigen 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 mithilfe 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. | |
|
string |
URL zum Anzeigen von Informationen zu diesem Band auf der Google Books-Website. (In LITE-Projektion) | |
userInfo.updated |
datetime |
Zeitstempel für den Zeitpunkt, zu dem dieses Band zuletzt durch eine Nutzeraktion geändert wurde, z. B. Aktualisierung einer Leseposition, Kauf eines Bandes oder Verfassen einer Rezension. (Datum/Uhrzeit-Format RFC 3339 UTC). | |
volumeInfo.canonicalVolumeLink |
string |
Kanonische URL für ein Volume. (In LITE-Projektion). | |
userInfo.isPreordered |
boolean |
Gibt an, ob dieses Volume vom authentifizierten Nutzer, der die Anfrage gesendet 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 diesen Band zulässig ist. Mögliche Werte sind ALLOWED, ALLOWED_FOR_ACCESSIBILITY oder NOT_ALLOWED. | |
accessInfo.epub.isAvailable |
boolean |
EPUB-Datei mit Fließtext, die entweder frei von Urheberrechten oder käuflich erwerbbar ist. (In LITE-Projektion). | |
accessInfo.pdf.isAvailable |
boolean |
Ist ein eingescanntes PDF (PDF, das entweder gemeinfrei oder zum Kauf verfügbar ist) (In LITE-Projektion). | |
accessInfo.webReaderLink |
string |
URL zum Lesen dieses Bandes auf der Google Books-Website. Der Link erlaubt Nutzern nicht, nicht sichtbare Volumes zu lesen. | |
accessInfo.downloadAccess |
nested object |
Informationen zu Zugriffsbeschränkungen für Downloadlizenzen. | |
accessInfo.downloadAccess.kind |
string |
Ressourcentyp. | |
accessInfo.downloadAccess.volumeId |
string |
Gibt das Volumen an, für das dieser Eintrag gilt. | |
accessInfo.downloadAccess.restricted |
boolean |
Gibt an, ob für dieses Volume Einschränkungen für den Downloadzugriff gelten. | |
accessInfo.downloadAccess.deviceAllowed |
boolean |
Gibt an, ob der Zugriff (Nutzer, Gerät, Volumen) eingeschränkt ist. | |
accessInfo.downloadAccess.justAcquired |
boolean |
Wenn „deviceAllowed“ angegeben ist, wird angegeben, ob der Zugriff gerade mit dieser Anfrage erworben wurde. | |
accessInfo.downloadAccess.maxDownloadDevices |
integer |
Bei Einschränkung die maximale Anzahl der Inhaltsdownloadlizenzen für dieses Volume. | |
accessInfo.downloadAccess.downloadsAcquired |
integer |
Bei Einschränkung die Anzahl der bereits erworbenen Lizenzen für Inhaltsdownloads (einschließlich der anfragenden Clients, falls lizenziert). | |
accessInfo.downloadAccess.nonce |
string |
Client-Nonce zur Bestätigung. Nur Downloadzugriff und Clientvalidierung. | |
accessInfo.downloadAccess.source |
string |
Client-App-ID zur Bestätigung. Nur Downloadzugriff und Clientvalidierung. | |
accessInfo.downloadAccess.reasonCode |
string |
Fehlercode/Ursachencode. Eventuell werden in Zukunft 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. |