Volume

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.list
books.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)
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.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.
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).
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.pdf object Informationen zu PDF-Inhalten (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.
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).
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.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.