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

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


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

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

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

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

  • viewwizard-embed : встраивает на страницу средство просмотра книг.
  • viewwizard-popup : добавляет кнопку, по которой можно нажать, чтобы открыть плавающий предварительный просмотр на странице.
  • viewwizard-linktogbs : вставляет кнопку, которая ссылается на предварительный просмотр на сайте Поиска книг.
  • viewwizard-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 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 ссылалась на пользовательскую страницу предварительного просмотра на вашем сайте, просто передайте в качестве второго аргумента GBS_insertPreviewButtonLink следующее:
      { 'alternativeUrl' : 'http://yoursite.com/your-preview-page' }