Ta strona została przetłumaczona przez Cloud Translation API.

Dynamic Links

Dynamiczne linki do Książek Google umożliwiają tworzenie bardziej niestandardowych i niezawodnych linków do Książek Google. Narzędzie to pozwala na przykład generować linki &inteligentne, które pojawiają się tylko wtedy, gdy książka jest w naszym indeksie, lub wyświetlać linki wskazujące użytkownikom, czy można zobaczyć ich podgląd w Książkach Google. Funkcja Dynamiczne linki pozwala też dołączyć do miniatury obraz linku do Książek Google. Dzięki temu dokumentowi możesz szybko dodać tę funkcję do swojej witryny.

Uwaga: ta funkcja była wcześniej znana jako interfejs Book Viewability API.

Kreator podglądu to narzędzie opracowane na podstawie dynamicznych linków, które jeszcze bardziej ułatwiają tworzenie linków do podglądu książek po prostu poprzez skopiowanie kilku wierszy kodu. Dokument jest przeznaczony dla bardziej zaawansowanych programistów, którzy chcą zmienić sposób tworzenia linków do usługi Książki Google.

Spis treści

Odbiorcy
Terminologia związana z wyszukiwaniem książek
Wprowadzenie
Wskazówki dotyczące promowania marki
Interfejs API po stronie klienta
1. Format adresu URL żądania
2. Format wyników JSON
Tryby synchroniczne i asynchroniczne
Najczęstsze pytania
Przykładowe fragmenty kodu

Odbiorcy

Dokumentacja linków dynamicznych jest przeznaczona dla programistów, którzy chcą tworzyć aplikacje internetowe zawierające linki do książek w Książkach Google. W tej dokumentacji zakładamy, że znasz protokół HTTP i podstawowy skrypt JavaScript.

Terminologia związana z wyszukiwaniem książek

W Książkach Google obowiązują lokalne ograniczenia dotyczące praw autorskich, dlatego w niektórych lokalizacjach podglądy i pełne wersje niektórych książek są niedostępne. Widoczność jest podzielona na te klasy:

Pełny widok: Można przeglądać całą książkę. Te książki mogą należeć do domeny publicznej.
Ograniczony podgląd: Fragment książki jest widoczny. Książka jest objęta prawami autorskimi, a Książki Google mają pozwolenie na udostępnienie jej użytkownikom. Te książki różnią się od książek w widoku krótkiego opisu, ponieważ użytkownicy mogą wyświetlać całe strony.
Widok krótkiego opisu i brak podglądu: Użytkownicy widzą tylko stronę „Informacje o książce”. Najczęściej dostępne są tylko krótkie fragmenty książki. Ta książka nie została przeskanowana lub jeśli jest objęta prawami autorskimi, a Książki Google nie mają uprawnień do wyświetlania więcej niż kilku & konkretnych haseł wyszukiwanych przez użytkownika.

Wprowadzenie

Dokumentacja linków statycznych opisuje bardzo prosty sposób generowania adresów URL stron konkretnych książek w Książkach Google. Czasem może się zdarzyć, że dana książka nie znajduje się w indeksie Książek Google lub użytkownik nie ma dostępu do jej podglądu. Linki statyczne są niewidoczne i niekiedy nie działają często tak, jak powinny.

Dynamiczne linki to alternatywna, zautomatyzowana metoda wysyłania zapytań o widoczność książki za pomocą JavaScriptu po stronie klienta. Dzięki temu możesz umieszczać w usłudze Książki Google bardziej niezawodne i przewidywalne linki do stron, dzięki czemu użytkownicy będą bardziej zadowoleni. Widoczność zmienia się w zależności od lokalizacji użytkownika, dlatego interfejs linku dynamicznego nie jest przeznaczony do zapytań po stronie serwera ani offline.

Aby dowiedzieć się, co potrafią linki dynamiczne, przejdź do przykładów kodu na końcu tego dokumentu.

Wskazówki dotyczące promowania marki

Podczas renderowania linków dynamicznych musisz przestrzegać wskazówek dotyczących promowania marki, które określają rodzinę interfejsu API Książek Google. W szczególności

Musisz zachować atrybucję i linki do Książek Google.
Do linków do podglądu w Książkach Google możesz używać tylko zatwierdzonego przycisku podglądu Google.
Wszelkie linki, przyciski, dokumentacja lub tekst opisowy muszą być zgodne z zasadami konwencji nazewnictwa. Na przykład nie należy używać czasowników "download" ani "read" w przypadku linków do podglądu w Książkach Google można pobrać tylko utwory z domeny publicznej.

Przykład promowania marki

Freakonomics: An Rogue Economist Explore the Hidden Side of

Autorzy: Steven Levitt i Stephen Dubner

W sekcji przykładów na końcu tego dokumentu znajdziesz dodatkowe przykłady zgodne z aktualnymi wskazówkami dotyczącymi promowania marki.

Interfejs API po stronie klienta

Podstawą dynamicznego linku po stronie klienta jest format URL, który umożliwia programistom tworzenie adresów URL z prośbą o informacje dotyczące jednej lub większej liczby książek i wysyłanie żądań do Książek Google przy użyciu tagu <script>.

Przykład składni:: <script src="https://books.google.com/books?bibkeys=ISBN:0451526538&jscmd=viewapi&callback=mycallback"></script>

Format żądania

Format adresu URL jest podobny do składni adresu URL używanego do łączenia z książkami, ale pole identyfikatora książki może zawierać wiele identyfikatorów książek rozdzielonych przecinkami oraz dodatkowe parametry 'jscmd' 'callback'. Możesz też użyć dodatkowych argumentów, aby kontrolować filtry widoczności.

Linki dynamiczne obsługują kilka różnych metod identyfikowania książek: numery ISBN, numery OCLC i klucze LCCN. Interfejs API zezwala na zapytania zbiorcze, których rozmiar nie przekracza maksymalnego rozmiaru żądania GET.

ISBN: &bibkeys=ISBN:0451526538 (Interfejs API obsługuje zarówno ISBN 10, jak i 13).
OCLC,: &bibkeys=OCLC:36792831
LCCN,: &bibkeys=LCCN:96072233

Format wyników JSON

Odpowiedź od tego wywołania będzie zawierać informacje o żądanych książkach zwróconych jako co najmniej jeden obiekt JSON. Obiekty JSON mają taką strukturę:

JsonSearchResult {
    string bib_key;
    string info_url;
    string preview_url;
    string thumbnail_url;
    string preview;
};

Zawierają one następujące informacje:

klucz bibliograficzny: Identyfikator używany do wysyłania zapytań do tej książki.
info_url: URL strony w Książkach Google z informacjami o książce (o tej stronie).
podgląd_url: Adres URL prowadzący do podglądu książki, który prowadzi użytkownika bezpośrednio do okładki książki. Jeśli w odpowiedzi na żądanie dostępny jest tylko widok krótkiego opisu lub brak książek do podglądu, URL podglądu nie zostanie zwrócony.
miniatura_adresu URL: URL do miniatury okładki książki.
podgląd: Wartość wskazująca stan widoczności książki: full (w przypadku książek w pełnym widoku), partial (w przypadku książek z ograniczonym podglądem) lub noview (w przypadku książek z fragmentem lub bez podglądu).
można umieścić: Wartość logiczna to true, jeśli książka może być umieszczona na stronach innych firm za pomocą przeglądarki umieszczonej na stronie wyszukiwarki książek.

Dynamic Links

Spis treści

Odbiorcy

Terminologia związana z wyszukiwaniem książek

Wprowadzenie

Wskazówki dotyczące promowania marki

Przykład promowania marki

Interfejs API po stronie klienta

Format żądania

Format wyników JSON

Parametry i dodatkowe pola

Tryb synchroniczny i asynchroniczny

Tryb asynchroniczny

Tryb synchroniczny

Najczęstsze pytania

Przykładowe fragmenty kodu