Vorschau-Assistent

Mit dem Vorschau-Assistenten lassen sich Vorschauen schnell, einfach und zuverlässig in Ihre Website einbinden. Sie können einen Buchbetrachter einbetten, einen Link zur Google Books-Suche hinzufügen oder Ihrer Website sogar ein Vorschau-Pop-up-Fenster hinzufügen. Dazu müssen Sie nur den Code generieren und auf Ihrer Seite einfügen. Sie können diesen Code auch mithilfe einfacher JavaScript-Funktionen anpassen.


Der Vorschau-Assistent ist eine einfache Bibliothek, die auf den APIs für Dynamic Links und Eingebettete Betrachter basiert. Wenn Sie ein erfahrener Entwickler sind und eine benutzerdefinierte Integration wünschen, sollten Sie die zugrunde liegenden APIs direkt 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 auch einige einfache JavaScript-"Hilfefunktionen" aufrufen. Laden Sie dazu zuerst die Vorschau des Assistenten. Eine Möglichkeit dazu ist, das folgende Tag zum Abschnitt <head> Ihrer Seite hinzuzufügen:

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

Nachdem Sie die Vorschaubibliothek geladen haben, können Sie eine der folgenden Funktionen aus <script>-Tags im Element <body> des Dokuments aufrufen. Wenn du beispielsweise die Schaltfläche „Google Preview“ einfügen möchtest, fügst du den Code dazu in ein <script>-Element an der gewünschten Position auf der Seite ein.

GBS_setSprache

GBS_setLanguage(languageCode)
    Ändert die Sprache von Schaltflächen oder Text, die nach dem Aufrufen dieser Funktion hinzugefügt werden. Dazu gehören die Sprache der Google Vorschau-Schaltfläche, die Sprache der Benutzeroberfläche der eingebetteten Vorschau usw.
    Parameter:
      string languageCode : Der gewünschte Sprachcode gemäß RFC 3066 (der Standardwert ist „en“). Zu den derzeit unterstützten Sprachcodes gehören 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-sk, bv, rv, rv, bv

GBS_setViewerOptions

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

GBS_setCobrandName

GBS_setCobrandName(cobrandName)
    Mit dieser Funktion legen Sie fest, dass Verlage und Webpublisher im Partnerprogramm die Website für die Co-Branded-Suche verwenden, wenn Vorschaulinks in die Google Books-Suche eingefügt werden. Durch Aufrufen dieser Funktion vor dem Einfügen einer Schaltfläche wird sichergestellt, dass die Nutzer das Logo des Partners über der Vorschau der Google Books-Suche sehen.
    Parameter:
      string cobrandName – Der Co-Branding-Name, der allen URLs der Google Books-Suche hinzugefügt werden soll. In den Vorschau-URLs für die Co-Branded-Suche steht dieser in der Regel nach /p/.

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

GBS_insertEmbeddedViewer

GBS_insertEmbeddedViewer(identifier, opt_width, opt_height)
    Fügt unabhängig davon, wo diese Funktion aufgerufen wird, eine eingebettete Buchvorschau ein. Wenn die Vorschau nicht verfügbar ist, wird kein Betrachter angezeigt.
    Parameter:
      Number opt_width – Die gewünschte Breite des Betrachters 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, wird mit dieser Funktion die Schaltfläche „Google Preview“ ausgegeben. Wenn du auf diese Schaltfläche klickst, wird oben auf deiner Seite ein unverankertes Vorschaufenster geöffnet. Ist keine Vorschau verfügbar, wird die Schaltfläche nicht gezeichnet.

    Für erfahrenere Entwickler ist möglicherweise die Eingebettete API, die intern verwendet wird.

    Parameter:
      string, Array identifier : Eine Vorschau-URL oder Buch-ID wie eine ISBN, OCLC oder LCCN. Weitere Informationen finden Sie unter Anfrageformat für dynamische Links. Wenn Sie mehrere alternative IDs für das Buch kennen, können Sie ein Array dieser IDs übergeben. Die Schaltfläche wird angezeigt, wenn für eine davon eine Vorschau verfügbar ist. 
GBS_insertPreviewButtonLink(identifiers, opt_options)
    Wenn die Buchvorschau verfügbar ist, wird mit dieser Funktion die Schaltfläche „Google Preview“ ausgegeben, über die Nutzer auf eine Vorschauseite des Buchs weitergeleitet werden. Standardmäßig sind hier Links zur Vorschau auf Google Books verfügbar. Sie können aber auch:
    • Link zu einer URL auf Ihrer Website, die wiederum einen eingebetteten Zuschauer enthalten sollte. Dazu kannst du eine optionale alternativeUrl-Option übergeben.
    • Link zu einer Co-Branded-Version der Buchvorschauseite, wenn GBS_setCobrandName vor dieser Funktion aufgerufen wird.
    Wenn dem Nutzer keine Vorschau zur Verfügung steht, wird keine Schaltfläche auf die Seite gezogen.
    Parameter:
      string, Array identifier : Eine Vorschau-URL oder Buch-ID wie eine ISBN, OCLC oder LCCN. Weitere Informationen finden Sie unter Anfrageformat für dynamische Links. Wenn Sie mehrere alternative IDs für das Buch kennen, können Sie ein Array dieser IDs übergeben. Die Schaltfläche wird angezeigt, wenn für eine davon eine Vorschau verfügbar ist.
      Object opt_options – optional: Eine Name-Wert-Zuordnung zum Konfigurieren des Verhaltens der Schaltfläche. Derzeit wird eine Option unterstützt: alternativeUrl. Wenn die Schaltfläche für die Google Vorschau beispielsweise mit einer benutzerdefinierten Vorschauseite auf Ihrer Website verknüpft werden soll, übergeben Sie einfach das folgende Argument als zweites Argument an GBS_insertPreviewButtonLink:
           { 'alternativeUrl' : 'http://yoursite.com/your-preview-page' }