Kreator podglądu umożliwia szybkie, łatwe i niezawodne integrowanie podglądu z witryną. Możesz umieścić podgląd książki, umieścić link do wyszukiwarki książek, a nawet dodać do witryny okno podglądu. Wystarczy, że wygenerujesz kod i wkleisz go na stronie. Możesz też dostosować ten kod za pomocą kilku prostych funkcji JavaScript.
Kreator podglądu to prosta biblioteka ułatwiąca korzystanie z interfejsów API dynamicznych linków i osadzonych przeglądarek. Jeśli jesteś zaawansowanym programistą i szukasz spersonalizowanej integracji, rozważ skorzystanie z podstawowych interfejsów API.
Generowanie kodu podglądu
Przykłady wygenerowanych podglądu
Poniższe przykłady zostały wygenerowane za pomocą kreatora podglądu.
- previewwizard-embedded: dodaje przeglądarkę książki do strony.
- previewwizard-popup: dodaje przycisk, który można kliknąć, aby otworzyć pływający podgląd na stronie.
- previewwizard-linktogbs: wstawia przycisk prowadzący do podglądu w witrynie Książek Play.
- previewwizard-customurl: wyświetla przycisk przekierowujący do określonego adresu URL.
Dostosowywanie kodu
Oprócz korzystania z kreatora powyżej można też bezpośrednio wywołać proste funkcje JavaScript pomocnicze. W tym celu musisz najpierw wczytać bibliotekę kreatora podglądu. Jednym ze sposobów jest dodanie tego tagu do sekcji <head>
strony:
<script type="text/javascript" src="https://books.google.com/books/previewlib.js"></script>
Po załadowaniu biblioteki podglądu możesz wywołać dowolną z tych funkcji z poziomu tagów <script>
w obrębie znaczników <body>
dokumentu. Jeśli na przykład chcesz wstawić przycisk „Google Preview”, możesz to zrobić w elemencie <script>
w wybranej pozycji przycisku na stronie.
GBS_setLanguage
GBS_setLanguage(languageCode)
- Zmienia język wszystkich przycisków lub tekstu dodanych po wywołaniu tej funkcji. Obejmuje to język przycisku „Podgląd w Google”, język interfejsu umieszczonego podglądu itd.
-
Parametry:
string languageCode
– żądany kod języka RFC 3066 (domyślnie „en” w przypadku języka angielskiego). Obecnie obsługiwane kody języka to: hy, bg, ca, zh-CN, zh-TW, hr, cs, da, nl, en, fil, fr, de, el, hi, hu, is, id, in, it, ja, ko, lv, lt, no, pl, pt-BR, pt-pt, tr
GBS_setViewerOptions
GBS_setViewerOptions(optionObj)
-
Parametry:
Object optionsObj
– zestaw par klucz-wartość przekazywany do konstruktora ViewDefault interfejsu API umieszczonego interfejsu API. Zwykle służy to do dostosowywania zaawansowanego.
GBS_setCobrandName
GBS_setCobrandName(cobrandName)
- Przeznaczona do użytku przez wydawców w programie partnerskim, ta funkcja ustawia witrynę z wyszukiwaniem pod wspólną marką, aby wykorzystać ją podczas wstawiania linków do podglądu w usłudze Książki. Wywołanie tej funkcji przed wstawieniem przycisku powoduje, że użytkownicy widzą logo partnera nad podglądem książki.
-
Parametry:
string cobrandName
– nazwa marki, która ma zostać dodana do dowolnego adresu URL w wyszukiwarce książek. Zwykle występuje to po /p/
w adresach URL podglądu wyszukiwania pod wspólną marką.
Na przykład ustawienie wartości sup
spowoduje przekierowanie użytkownika do linków takich jak
https://books.google.com/books/p/sup?id=Q8ysL64pM54C&printsec=frontcover
, a nie do wartości domyślnych
https://books.google.com/books?id=Q8ysL64pM54C&printsec=frontcover
GBS_insertembeddedViewer,
GBS_insertEmbeddedViewer(identifier, opt_width, opt_height)
- Wstawia podgląd umieszczonego książki w miejscu, gdzie wywołana jest ta funkcja. Jeśli podgląd jest niedostępny, żaden przeglądający nie jest wyświetlany.
-
Parametry:
string identifier
– adres URL podglądu lub identyfikator książki, taki jak numer ISBN, OCLC czy numer LCCN. Zobacz Format żądania linków dynamicznych.
Number opt_width
– wymagana szerokość przeglądarki w pikselach.
Number opt_height
– wymagana wysokość widza w pikselach.
GBS_insertPodglądButtonPopup
GBS_insertPreviewButtonPopup(identifiers)
- Jeśli dostępny jest podgląd książki, funkcja zapisuje przycisk „Podgląd Google”. Kliknięcie tego przycisku spowoduje otwarcie „pływającego okna podglądu” u góry strony. Jeśli podgląd nie jest dostępny, przycisk nie jest widoczny.
Być może bardziej zaawansowani deweloperzy mogą zainteresować się interfejsem embedded Browser API, który jest używany wewnętrznie.
-
Parametry:
string, Array identifier
– adres URL podglądu lub identyfikator książki, taki jak numer ISBN, OCLC czy numer LCCN. Zobacz Format żądania linków dynamicznych. Jeśli znasz kilka alternatywnych identyfikatorów książki, możesz przekazać ich tablicę. Pojawi się przycisk, jeśli dla któregoś z nich jest dostępny podgląd.
GBS_insertPodgląd PrzyciskLink
GBS_insertPreviewButtonLink(identifiers, opt_options)
- Jeśli dostępny jest podgląd książki, ta funkcja tworzy przycisk „Google Preview” prowadzący bezpośrednio do strony podglądu książki. Domyślnie prowadzi on do podglądu w Książkach Google, ale możesz też:
- linku do adresu URL w witrynie (który z kolei powinien zawierać osadzony przegląd). Możesz to zrobić, przesyłając opcjonalną opcję
alternativeUrl
. - linku do wersji strony zawierającej wspólną książkę, jeśli przed tą funkcją zostanie wywołana właściwość GBS_setCobrandName.
-
Parametry:
string, Array identifier
– adres URL podglądu lub identyfikator książki, taki jak numer ISBN, OCLC czy numer LCCN. Zobacz Format żądania linków dynamicznych. Jeśli znasz kilka alternatywnych identyfikatorów książki, możesz przekazać ich tablicę. Pojawi się przycisk, jeśli dla któregoś z nich jest dostępny podgląd.
Object opt_options
– opcjonalne – mapa nazwy i wartości używana do konfigurowania działania przycisku. Obecnie obsługiwana jest jedna opcja: alternativeUrl
. Jeśli na przykład chcesz, aby przycisk podglądu Google prowadził do niestandardowej strony podglądu w Twojej witrynie, jako drugi argument prześlij GBS_insertPreviewButtonLink
: { 'alternativeUrl' : 'http://yoursite.com/your-preview-page' }