Kreator podglądu

Kreator podglądu został zaprojektowany tak, aby umożliwić szybkie, łatwe i niezawodne integrowanie podglądów z witryną. Możesz umieścić w witrynie przeglądarkę książek, link do Book Search, a nawet dodać do witryny „wyskakujące okienko” z podglądem – wystarczy wygenerować kod i wkleić go na stronie. Możesz też dostosować ten kod, używając kilku prostych funkcji JavaScriptu.


Kreator podglądu to prosta biblioteka, którą stworzyliśmy na bazie interfejsów API Dynamic Links i Embedded Wyświetlający. Jeśli jesteś zaawansowanym programistą i szukasz spersonalizowanej integracji, zastanów się nad użyciem bezpośrednio bazowych interfejsów API.

Generowanie kodu podglądu

Przykłady wygenerowanych podglądów

Poniższe przykłady zostały wygenerowane za pomocą kreatora podglądu.

Dostosuj kod

Oprócz korzystania z powyższego kreatora możesz też bezpośrednio wywoływać niektóre proste funkcje JavaScriptu jako „pomocnicze”. W tym celu musisz najpierw załadować bibliotekę kreatora podglądu. Aby to zrobić, dodaj na swojej stronie ten tag w sekcji <head>:

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

Po załadowaniu biblioteki podglądu możesz wywoływać dowolne z poniższych funkcji z poziomu tagów <script> w obiekcie <body> dokumentu. Jeśli na przykład chcesz wstawić przycisk „Podgląd Google”, musisz umieścić kod służący do tego celu w elemencie <script> w wybranym miejscu na stronie.

GBS_setLanguage

GBS_setLanguage(languageCode)
    Zmienia język przycisków lub tekstu dodanego po wywołaniu tej funkcji. Dotyczy to języka przycisku „Podgląd Google”, języka interfejsu umieszczonego podglądu itd.
    Parametry:
      string languageCode – wymagany kod języka RFC 3066 (domyślnie „en” w przypadku języka angielskiego). Obecnie obsługiwane kody języków to: 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, pt-PT,

GBS_setViewerOptions

GBS_setViewerOptions(optionObj)

GBS_setCobrandName

GBS_setCobrandName(cobrandName)
    Ta funkcja jest przeznaczona do użytku przez wydawców w programie partnerskim. Ta funkcja ustawia witrynę Wyszukiwanie pod wspólną marką, która będzie używana do wstawiania dowolnych linków podglądu do Book Search. Wywołanie tej funkcji przed wstawieniem przycisku powoduje, że użytkownicy widzą logo partnera nad podglądami w programie Book Search.
    Parametry:
      string cobrandName – nazwa wspólnych marek, która zostanie dodana do wszystkich adresów URL usługi Book Search. Zazwyczaj jest to nazwa po /p/ w istniejących adresach URL podglądu wyszukiwania pod wspólną marką.

      Na przykład ustawienie wartości sup spowoduje, że użytkownik przejdzie do linków w rodzaju
      https://books.google.com/books/p/sup?id=Q8ysL64pM54C&printsec=frontcover
      zamiast do linków domyślnych
      https://books.google.com/books?id=Q8ysL64pM54C&printsec=frontcover

GBS_insertEmbeddedViewer

GBS_insertEmbeddedViewer(identifier, opt_width, opt_height)
    Wstawia podgląd osadzonej książki wszędzie tam, gdzie wywoływana jest ta funkcja. Jeśli podgląd jest niedostępny, nie wyświetla się żadna przeglądarka.
    Parametry:
      Number opt_width – żądana szerokość przeglądarki (w pikselach).
      Number opt_height – żądana wysokość przeglądarki (w pikselach).

GBS_insertPreviewButtonPopup

GBS_insertPreviewButtonPopup(identifiers)
    Jeśli podgląd książki jest dostępny, ta funkcja tworzy przycisk „Podgląd Google”. Kliknięcie tego przycisku powoduje otwarcie pływającego okna podglądu bezpośrednio w górnej części strony. Jeśli podgląd jest niedostępny, przycisk nie jest widoczny.

    Bardziej zaawansowani programiści mogą zainteresować się interfejsem Embedded Wyświetlający API, którego ta funkcja używa wewnętrznie.

    Parametry:
      string, Array identifier – adres URL podglądu lub identyfikator książki, np. numer ISBN, OCLC lub LCCN. Zobacz Format żądania linków dynamicznych. Jeśli znasz kilka alternatywnych identyfikatorów książki, możesz przekazać ich tablicę. Przycisk pojawi się, jeśli dla któregoś z nich dostępny będzie podgląd. 
GBS_insertPreviewButtonLink(identifiers, opt_options)
    Jeśli podgląd książki jest dostępny, funkcja ta tworzy przycisk „Podgląd w Google”, który prowadzi do strony podglądu książki. Domyślnie ten link prowadzi do podglądu w Książkach Google, ale możesz też:
    • do adresu URL w Twojej witrynie (który powinien z kolei zawierać umieszczoną przeglądarkę). Możesz to zrobić, przekazując opcjonalną opcję alternativeUrl.
    • do wersji strony podglądu książki pod wspólną marką, jeśli przed tą funkcją wywoływana jest funkcja GBS_setCobrandName.
    Jeśli podgląd nie jest dostępny dla użytkownika, na stronie nie będzie wyświetlany żaden przycisk.
    Parametry:
      string, Array identifier – adres URL podglądu lub identyfikator książki, np. numer ISBN, OCLC lub LCCN. Zobacz Format żądania linków dynamicznych. Jeśli znasz kilka alternatywnych identyfikatorów książki, możesz przekazać ich tablicę. Przycisk pojawi się, jeśli dla któregoś z nich dostępny będzie podgląd.
      Object opt_options – opcjonalny – mapa nazwa-wartość używana do konfigurowania działania przycisku. Obecnie obsługiwana jest 1 opcja: alternativeUrl. Jeśli na przykład przycisk podglądu Google ma zawierać link do niestandardowej strony podglądu w Twojej witrynie, po prostu przekaż do GBS_insertPreviewButtonLink ten argument jako drugi argument:
           { 'alternativeUrl' : 'http://yoursite.com/your-preview-page' }