Мастер предварительного просмотра

Мастер предварительного просмотра позволяет быстро, легко и надежно интегрировать предварительный просмотр на ваш сайт. Вы можете встроить средство просмотра книг, ссылку на Поиск книг или даже добавить всплывающее окно предварительного просмотра на свой сайт — все, что вам нужно сделать, это сгенерировать код и вставить его на свою страницу. Вы также можете настроить этот код , используя некоторые простые функции JavaScript.


Мастер предварительного просмотра — это простая удобная библиотека, которую мы создали на основе наших API-интерфейсов Dynamic Links и Embedded Viewer . Если вы продвинутый разработчик, которому нужна настраиваемая интеграция, рассмотрите возможность прямого использования базовых API.

Создайте код предварительного просмотра

Примеры сгенерированных превью

Следующие примеры были созданы с помощью мастера предварительного просмотра.

  • previewwizard-embed : встраивает средство просмотра книг на страницу.
  • previewwizard-popup : добавляет кнопку, по которой можно щелкнуть, чтобы открыть плавающий предварительный просмотр над страницей.
  • previewwizard-linktogbs : вставляет кнопку, которая ссылается на предварительный просмотр на сайте Поиска книг.
  • previewwizard-customurl : показывает кнопку, которая ведет к определенному URL-адресу.

Настройте свой код

Помимо использования описанного выше мастера, вы можете напрямую вызывать некоторые простые «вспомогательные» функции JavaScript. Для этого следует сначала загрузить библиотеку Preview Wizard. Один из способов сделать это — добавить следующий тег в раздел <head> вашей страницы:

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

Загрузив библиотеку предварительного просмотра, вы можете вызывать любую из следующих функций из тегов <script> внутри <body> вашего документа. Например, если вы хотите вставить кнопку «Предварительный просмотр Google», вы должны поместить код для этого в элемент <script> в нужном месте кнопки на странице.

GBS_setLanguage

GBS_setLanguage(languageCode)
    Изменяет язык любых кнопок или текста, добавленного после вызова этой функции. Это включает в себя язык кнопки «Предварительный просмотр Google», язык интерфейса встроенного предварительного просмотра и т. д.
    Параметры:
      string languageCode — требуемый код языка RFC 3066 (по умолчанию «en» для английского). В настоящее время поддерживаются коды языков: 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-PT, ro, ru, sr, sk, sl, es, sv, th, tr, uk и vi.

GBS_setViewerOptions

GBS_setViewerOptions(optionObj)
    Параметры:
      Object optionsObj — набор пар ключ-значение, передаваемый конструктору DefaultViewer Embedded Viewer API. Обычно это используется для расширенных настроек.

GBS_setCobrandName

GBS_setCobrandName(cobrandName)
    Эта функция предназначена для использования издателями в Партнерской программе . Эта функция позволяет настроить сайт совместного поиска для использования при вставке любых ссылок предварительного просмотра в Поиск книг. Вызов этой функции перед вставкой кнопки гарантирует, что пользователи увидят логотип партнера над предварительным просмотром Поиска книг.
    Параметры:
      string cobrandName — название совместного бренда, которое будет добавлено к любым URL-адресам Поиска книг. Обычно это то, что следует после /p/ в существующих URL-адресах предварительного просмотра совместного поиска.

      Например, установка значения sup приведет к тому, что пользователь будет переходить по таким ссылкам, как
      https://books.google.com/books/p/sup?id=Q8ysL64pM54C&printsec=frontcover
      а не по умолчанию
      https://books.google.com/books?id=Q8ysL64pM54C&printsec=frontcover

GBS_insertEmbeddedViewer

GBS_insertEmbeddedViewer(identifier, opt_width, opt_height)
    Вставляет встроенный предварительный просмотр книги везде, где вызывается эта функция. Если предварительный просмотр недоступен, средство просмотра не отображается.
    Параметры:
      Number opt_width — желаемая ширина вьювера, в пикселях.
      Number opt_height — желаемая высота просмотра в пикселях.

GBS_insertPreviewButtonPopup

GBS_insertPreviewButtonPopup(identifiers)
    Если доступен предварительный просмотр книги, эта функция выводит кнопку «Предварительный просмотр Google». При нажатии на эту кнопку открывается «плавающее окно предварительного просмотра» прямо вверху вашей страницы. Если предварительный просмотр недоступен, кнопка не рисуется.

    Более искушенным разработчикам может быть интересен Embedded Viewer API , который эта функция использует внутри.

    Параметры:
      string, Array identifier — URL-адрес предварительного просмотра или идентификатор книги, например номер ISBN, OCLC или LCCN. См. Формат запроса динамических ссылок . Если вы знаете несколько альтернативных идентификаторов книги, вы можете передать массив этих идентификаторов, и кнопка появится, если для любого из них доступен предварительный просмотр. 
GBS_insertPreviewButtonLink(identifiers, opt_options)
    Если доступен предварительный просмотр книги, эта функция выводит кнопку «Предварительный просмотр Google», которая просто указывает на страницу предварительного просмотра книги. По умолчанию это ссылка на предварительный просмотр в Google Книгах, но вы также можете:
    • ссылка на URL-адрес вашего сайта (который, в свою очередь, должен содержать встроенное средство просмотра). Вы можете сделать это, передав необязательную опцию alternativeUrl .
    • ссылка на кобрендинговую версию страницы предварительного просмотра книги, если перед этой функцией вызывается GBS_setCobrandName .
    Если для пользователя недоступен предварительный просмотр, на странице не отображается кнопка.
    Параметры:
      string, Array identifier — URL-адрес предварительного просмотра или идентификатор книги, например номер ISBN, OCLC или LCCN. См. Формат запроса динамических ссылок . Если вы знаете несколько альтернативных идентификаторов книги, вы можете передать массив этих идентификаторов, и кнопка появится, если для любого из них доступен предварительный просмотр.
      Object opt_options — необязательный — карта «имя-значение», используемая для настройки поведения кнопки. В настоящее время поддерживается один вариант: alternativeUrl . Например, чтобы кнопка Google Preview ссылалась на пользовательскую страницу предварительного просмотра на вашем сайте, просто передайте следующий аргумент GBS_insertPreviewButtonLink в качестве второго аргумента:
      { 'alternativeUrl' : 'http://yoursite.com/your-preview-page' }