Vorschau-Assistent

Mit dem Vorschauassistenten können Sie Vorschauen schnell, einfach und zuverlässig in Ihre Website integrieren. Sie können eine Buchansicht einbetten, einen Link zur Buchsuche einfügen oder sogar ein Pop-up-Vorschaufenster zu Ihrer Website hinzufügen. Dazu müssen Sie lediglich den Code generieren und ihn auf Ihrer Seite einfügen. Mit einigen einfachen JavaScript-Funktionen kannst du diesen Code anpassen.


Der Preview Wizard ist eine einfache Convenience-Bibliothek, die auf unseren APIs für Dynamic Links und Embedded Viewer basiert. Wenn Sie ein erfahrener Entwickler sind, der sich eine benutzerdefinierte Integration wünschen, kann es sinnvoll sein, die zugrunde liegenden APIs direkt zu verwenden.

Vorschaucode generieren

Beispiele für generierte Vorschauen

Die folgenden Beispiele wurden mit dem Vorschau-Assistenten generiert.

Code anpassen

Neben der Verwendung des obigen Assistenten können Sie einige einfache JavaScript-"Hilfsfunktionen"-Funktionen direkt aufrufen. Dazu müssen Sie zuerst die Bibliothek des Vorschauassistenten laden. Dazu kannst du beispielsweise das folgende Tag in den Abschnitt <head> deiner Seite einfügen:

<script type="text/javascript" src="https://books.google.com/books/previewlib.js"></script>

Nach dem Laden der Vorschaubibliothek können Sie eine der folgenden Funktionen über die <script>-Tags im <body> Ihres Dokuments aufrufen. Wenn Sie beispielsweise die Schaltfläche „Google Preview“ einfügen möchten, müssen Sie den Code dafür in einem <script>-Element an der gewünschten Position der Schaltfläche auf der Seite platzieren.

GBS_setLanguage

GBS_setLanguage(languageCode)
    Ändert die Sprache aller Schaltflächen oder Texte, die nach dem Aufruf dieser Funktion hinzugefügt werden. Dazu gehören die Sprache der Schaltfläche "Google Vorschau", die Sprache der Benutzeroberfläche der eingebetteten Vorschau usw.
    Parameter:
      string languageCode – Der gewünschte RFC 3066-Sprachcode (Standard ist „en“ für Englisch). Folgende Sprachcodes werden derzeit unterstützt: hy, bg, ca, zh-CN, zh-TW, hr, cs, da, nl, en, fil, fi, fr, de, el, hi, hu, is, id, in, it, ja, ko, lv, lt, no, pl, pt-BR, pt-ru, sr.

GBS_setViewerOptions

GBS_setViewerOptions(optionObj)
    Parameter:
      Object optionsObj – Eine Reihe von Schlüssel/Wert-Paaren, die an den DefaultViewer-Konstruktor der Embedded Viewer API übergeben werden. Dies wird normalerweise für erweiterte Anpassungen verwendet.

GBS_setCobrandName

GBS_setCobrandName(cobrandName)
    Diese Funktion ist für die Verwendung durch Verlage und Webpublisher im Partnerprogramm vorgesehen und legt die Website für die Co-Branded-Suche fest, die beim Einfügen von Vorschaulinks zur Buchsuche verwendet wird. Durch das Aufrufen dieser Funktion vor dem Einfügen einer Schaltfläche wird sichergestellt, dass User das Logo des Partners über den Vorschauen der Buchsuche sehen.
    Parameter:
      string cobrandName – Co-Branded-Name, der allen Buchsuche-URLs hinzugefügt werden soll. Dies ist in der Regel der Teil, der in vorhandenen Vorschau-URLs für die Co-Branded-Suche nach /p/ steht.

      Wenn Sie den Wert beispielsweise auf sup setzen, wird der Nutzer zu Links wie
      https://books.google.com/books/p/sup?id=Q8ysL64pM54C&printsec=frontcover
      weitergeleitet statt zu
      https://books.google.com/books?id=Q8ysL64pM54C&printsec=frontcover

GBS_insertEmbeddedViewer

GBS_insertEmbeddedViewer(identifier, opt_width, opt_height)
    Fügt bei jedem Aufruf dieser Funktion eine eingebettete Buchvorschau ein. Ist die Vorschau nicht verfügbar, wird kein Viewer angezeigt.
    Parameter:
      Number opt_width : die gewünschte Breite des Viewer in Pixeln.
      Number opt_height : die gewünschte Höhe des Betrachters in Pixeln.

GBS_insertPreviewButtonPopup

GBS_insertPreviewButtonPopup(identifiers)
    Wenn die Buchvorschau verfügbar ist, gibt diese Funktion die Schaltfläche „Google Vorschau“ aus. Wenn Sie auf diese Schaltfläche klicken, wird ein unverankertes Vorschaufenster direkt über Ihrer Seite geöffnet. Ist keine Vorschau verfügbar, wird die Schaltfläche nicht gezeichnet.

    Fortgeschrittene Entwickler sind möglicherweise an der Embedded Viewer API interessiert, die diese Funktion intern verwendet.

    Parameter:
      string, Array identifier : Eine Vorschau-URL oder eine Buch-ID, z. B. eine ISBN-, OCLC- oder LCCN-Nummer. Siehe Anfrageformat für dynamische Links. Wenn Sie mehrere alternative IDs für das Buch kennen, können Sie eine Reihe dieser IDs übergeben. Die Schaltfläche wird dann angezeigt, wenn für eine dieser IDs eine Vorschau verfügbar ist. 
GBS_insertPreviewButtonLink(identifiers, opt_options)
    Wenn die Buchvorschau verfügbar ist, erstellt diese Funktion die Schaltfläche „Google Vorschau“, die einfach zu einer Vorschauseite für das Buch führt. Standardmäßig wird hier ein Link zur Vorschau bei Google Books angezeigt. Sie haben aber auch folgende Möglichkeiten:
    • mit einer URL auf Ihrer Website verknüpfen (die wiederum einen eingebetteten Viewer enthalten sollte). Dazu übergeben Sie eine optionale alternativeUrl-Option.
    • einen Link zu einer Co-Branded-Version der Buchvorschauseite, wenn GBS_setCobrandName vor dieser Funktion aufgerufen wird.
    Wenn für den Nutzer keine Vorschau verfügbar ist, wird keine Schaltfläche auf der Seite gezeichnet.
    Parameter:
      string, Array identifier : Eine Vorschau-URL oder eine Buch-ID, z. B. eine ISBN-, OCLC- oder LCCN-Nummer. Siehe Anfrageformat für dynamische Links. Wenn Sie mehrere alternative IDs für das Buch kennen, können Sie eine Reihe dieser IDs übergeben. Die Schaltfläche wird dann angezeigt, wenn für eine dieser IDs eine Vorschau verfügbar ist.
      Object opt_options (optional) – Eine Name/Wert-Zuordnung, mit der das Verhalten der Schaltfläche konfiguriert wird. Derzeit wird eine Option unterstützt: alternativeUrl. Wenn beispielsweise die Schaltfläche für die Google Vorschau auf eine benutzerdefinierte Vorschauseite auf Ihrer Website verweisen soll, übergeben Sie einfach Folgendes als zweites Argument an GBS_insertPreviewButtonLink:
           { 'alternativeUrl' : 'http://yoursite.com/your-preview-page' }